Belgian Amiga Club - ADF Collection/BS1 part 27.zip/BS1 part 27/DirPousV4.10C.adf/dopus41.doc

Text File | 1993-09-26 | 241KB | 7,707 lines

                             DIRECTORYOPUS 4.10
                              COMPLEATE MANUAL
                             RELEASED 23/7/1993
                         Corrected By Celic/$ceptic
             THE 4.10 FEATURES YOU MAY FIND AT THE END OF THIS FILE


                                Chapter 1

A DirectoryOpus
Walk-through

1. 1 What is DirectoryOpus?

The theory behind Dir Opus is quite simple. On the screen there are two windows.
These are called directory windows. You can read a directory into each of these
from any device accessible by the amiga. You can read a directory into each of
these from any device accessible by the amiga. You can select files and/ or
directories in either of these widows, then minipulate them almost any way
you like. Selected entries can be copied to the opposite window, Deleted or
renamed;  text files can be read, picture files can be viewed, and sound can
be herd. DirectoryOpus ofers much more than these "bare bones" features,
and you will learn more later in this manual.

1. 2 Files and Directories

The Amigas dos (disk operating system) deals with two kinds of data arrangement
files and directories.
Each file and directory must be given a unique name; within a directory you
cannot have two files, two dirs. or a file and dir of the same name.

1. 2. 1 Files

Any data you record on a disk is stored in a file. Files contain information.
which may be from a data base, from a word processor, from a painting prog,
or the entire contents of a programe.
The size of a file is expressed in bytes, each byte being equivalent to
one character. Storing the string hello in a file would use five bytes,
as the word hello is five characters long.
Whether a file can be displayed, executed, deleted, edited, or considered as
a script file, depends upon attributes that are explaind later.
All files have a date stamp which shows what the system date and time where
the last time the file was writtten to.
Files may also have a comment of up to 79 characters attached to them.

1. 2. 2 Directories

To store information in a logical manner, disks are generaly organized into
directories, which are often referd to as drawers. If you picture a disk as
a fileing cabinet, with your programs, data base files and pictures as the
actual files, then directories are the drawers of the fileing cabinet.
some of these drawers have futher drawers inside them, called sub dirs,
which themselves can contain drawers, and so on, indefinitely.
the dir or sub dir containing any given sub dir is known as its parent
dir.
The highest level of organizatlan is the root dir. If the dir is a filing
cabinet, then the root dir is the room it stands in.
The route you take along a dir tree to reach a file is called a path.
as you procced along the path, each branch of the tree is seperated from
the next branch by a / character. For example, the path of archives is
expressed as work: downloads/ archves/ picture. arc.
To refer to pcture. arc, you use what is called a path name. This consists
of a files path, followed by the name of a file. Picture. arc, s path name
would be work ; downloads/ archives/ picture. arc.
The number of files and sub dir any given dir can contain is limited only
by the ammount of space on the disk.

1. 3 Installing DirOpus

If your computer does not have a hard drive, you may want to run directory
opus from the distribution disk; otherwise you need to use the installation
program, Installopus, which inserts Directory Opus into your hard disks root
directory. It will modify your user startup sequence. Installopus allows
you to choose the approach best suited to your level of expertise.

For the novice, installopus inserts dir opus into your hard disks
root directory and does everything for you, offering you few choicews.
you may choose to have the directory opus screen displayed when you
first boot up your computer, otherwise you may run directory opus
from the workbench or from the cli.

At a more ambitious level, installopus allows you to select the
directories into which directory opus is to be installed.

The expert user can take control: installopus allows you to define
every singlechoice available, and assumes that you know what you are
doing. You are able to modify your startup sequence to your needs.

For more information, use installopus built in help system.

1. 4 Running Directory Opus

There are three common ways of running directory opus.

From Workbench

From CLI

From your Startup Sequence

each are described below.

1. 4. 1 Starting from Workbench

The easiest way to run directory opus is from the Workbench.
double- click on the directory opus icon on the Workbench
screen and, several seconds later, the directory opus screen
will appear.

1. 4. 2 Starting from a CLI

To run directory opus from the CLI enter:

dopus:DirectoryOpus

This assumes one of two things. Either you are running directory
opus from a floppy drive containing the directory opus diskette,
or you have it installed on a hard drive with an assignment of
dopus: to its location. ( the install utility can create the assignment
in your startup sequence) .

1. 4. 3 Automatic startup in the startup-sequence

The startup-sequence is a script file that is automatically executed
when you first turn on the computer. It can contain instructions to
do many different things, including running directory opus.
Either the installopus utility can modify your startup-sequence
for you, or you can do it yourself. To modify your startup sequence
you need a text editor such as commodores ed or memax. A highly
recommended commercial text editor is cygnused professional, by
asdg-inc. This is the text editor with which directory opus was
written, and is a very powerful tool.
Run your text editor, and load your startup-sequence into it. The
startup- sequence resides in the s: directory of your boot disk. Pick
a convenient place to put the new instruction. A good place would
be the line immediately before the endcli instruction ( at the end),
but you can realy put it anywhere. Add the line:

assign dopus: dh0: tools/ dopus
dopus: DirectoryOpus -i

This assumes you have installed directory opus in a directory called
dh0: tools/ dopus. Of course you need to use the actual directory path.

The -i at the end of the instruction tells directory opus to start up
iconifed, which means that the program will open only a little window
on the workbench screen, instead of its own custom screen, and will
sit unobtrusively in the background until needed. From the workbench,
you can add a tooltype of iconstart= 1 to the directory opus icon,
for the sadme effect. If you do not want directory opus to start up
iconified, simply remove the -i.

The more technically inclined may notice that there is no run on
the instruction line. This is because directory opus detaches itself,
freeing up the cli and allowing it to continue with the startup
sequence ( and ulitmately closing).

Make sure you save the startup-sequence once you have modified it.
If your changes make sence, directory opus will be run automatically
when you boot up.

There is another flag you can use when you run directory opus.
The -c flag tells directory opus where to load the configuration
file from. For instance, -cdh1: stuff/ DirectoryOpus. cfg would load
 (and subsequently save) the configuration file from dh1: stuff
/ DirectoryOpus. cfg. From workbench, a tooltype of configfile= dh1:
stuff/ DirectoryOpus. cfg would have the same effect. By default,
it will look in dopus: modules.

1. 5 Introduction to using directory opus

This section gives you a short tour of directory opus. It describes
directory opus in its default configuration. The various configuration
options will be described in a later chapter.

1. 5. 1 Aborting

Before using the program, it is inportant to know how to abort an
action. Most functions can be aborted once they have begun, and this
can be usful if you accidentally start deleting the contents of your
hard drive.

To abort, press the left and right mouse buttons simultaneously. This
will only take effect if the directory opus screen is active (i. e, it
is at the front of the display).

Do not be alarmed if the action does not abort immediately; some
functions such as copy, will have to finish the file they are working
upon before abotring.

1. 5. 2 Directory opus components

Lets start with a brief description of the main components of the
directory opus display.

Title bar: the title bar is at the very top of the directory opus
display. It is used to display various status or error messages.
If you are unsure what directory opus is doing, it is a good idea to
look in the title bar for a hint. The title bar is also used to
reposition the directory opus screen.

Clock/Memory bar: the clock/ memory bar is at the bottom of the directory
opus display. It displays current memory and time information.

Directory window: a directory window allows you to display the
files and sub- directories contained in a directory. You can select
(and deselect) files and sub-directories. Directory opus has two
directory windows. The directory windows are described in greater
detail below.

Custom buttons: the custom buttons perform actions which usually
trigger an operation on the selected files in the active directory
window.

Drive buttons: the drive buttons read the contents of a specific
directory and display them in the currently active directory window.

Custom menus: custom menus, like custom buttons, perform actions.

Note: many parts of the directory opus interface use the right
mouse button for alternative operations. As with DPaint, the mouse
pointer must be positioned on the title bar when the right mouse
button is clicked for the menu titles to appear.

Tiny buttons: four tiny buttons are positioned between the two
directory windows, and six tiny buttons are placed on the clock/
memory bar.

1. 5. 3 Directory Windows:

There are two directory windows. One window is active at a time.
because some actions, such as copy, work with selected files in the
active directory window and use the inactive window as the destination,
The active window is referred to as the source window and the
inactive window is referred to as the destination window.

Selecting the active directory window

Clicking anywhere in a window with either mouse button will activate
that window. Unless you are extremely precice in your placement of
the pointer, however, clicking with the left mouse button to activate
a window may lead to your selecting an unwanted entry. This is when
using the right mouse button can be useful, as selecting entries is
a left mouse button function, but clicking with the right mouse
button can never have that effect.

Pressing the space bar activates the inactive directory window. This
allows you to toggle between the active and inactive windows.

Directory window components

Directory field

Disk name

Window area

Window view sliders

Next and previous buffer buttons


-------------------------------------------------------------------

Directory field

Many directory opus functions require that you read a directory
into the active directory window. To read any directory, enter the
name into the directory field.

When you click in a directory field it will be activated, and a cursor
will appear. Pressing the return key will activate the directory field
for the active directory window. Once the field is activated, enter the
name of the directory you want.
There are several editing features you can use:

Backspace: deletes the character to the left of the cursor

Delete: deletes the character under the cursor

Cursor key: moves the cursor one space in the direction of the arrow

Cursor key+shift: moves the cursor to the beginning or end of the
string.

Right Amiga + x key: this is known as amiga-x erases the entire string

Right Amiga + q key this is known as amiga-x restores the contents
of a field to the previous information.

Once you have entered the pathname you wish to read, press return.
You will see the directory window activate ( if it is not already
active), and the directory will be read.

Disk name

The disk name area of the directory window shows the disk or
volume name for the currently displayed directory. This area
also displays the amount of free space on the directorys volume.

Window area

The window area of the directory window displays the directorys
files and sub- directorys.

Selecting files

To select an entry, file or sub- directory, click on it with the
left mouse button. If you hold down the left mouse button and
move the mouse up or down, all entries passed over will be
highlighted. This is called drag selecting.
When you click on an entry which is already selected, it will
deselect it. By drag- selecting when you click on a selected entry,
already selected entries that are passed over will be deselected.

Entering sub-directorys

Many directories that you read in will contain sub- directories.
Instead of having to type in the name of a sub-directory, you
need only to double click on it. Zhis will load the sub-directory
into the same directory window. Opening the sub-directory in the
other directory window allows you to copy files between the sub
directory and its parent. To do this, you perform a click move click
 (click m click) with the left mouse button. Click m click means
to click first on a sub directory entry then to move the mouse
pointer to the other (inactive) window and click again. This can
be tricky because the two clicks must occur within the amiga
configured double click time (see amiga input preferences).
An alternative method to click m click (which requires less
mouse pointer gymnastics), is to click and hold on an unselected
sub directory entry with the left mouse button. Then, without releasing
the left mouse button, press and release the right mouse button.
Without releasing the left mouse button, move the mouse pointer
to the inactive window. As you move the mouse pointer, a copy of
the selected sub directory will follow the mouse. When you
position the mouse pointer over the inactive window, release
the mouse button; the sub directory will now be read into the inactive
windoow, which now will become the active directory window.

A final alternative is to click and hold on an unselected
sub directory entry with the left mouse button. Then, without releasing
the left mouse button, move the mouse pointer to the unselected
directory window. The trick to this method is to move the mouse
pointer horizontally without moving up or down. Should you
inadvertently move the mouse pointer over an entry above or below
the selected sub directory, it will not follow the mouse pointer to
the other window. When you do it correctly, a copy of the selected sub
directory will follow the mouse pointer over to the inactive window
and will be read when you release the mouse pointer.

Moving to a parent directory:

If the directory displayed in a directory window is a sub directory,
you may wish to return to its parent directory. You could return to
the parent directory by editing the directory field text directly,
but the procedure is cumbersome and error prone; there are better ways.

The default configuration includes a custom button which returns you
to the parent directory.

Each directory window contains a hidden parent button on the outer
edge of the window area which will move you to the parent directory.
On the left directory window, it is the white border on the far left.
On the right directory window, it is the black border on the far right.
When you click the left mouse button on a hidden parent button, directory
opus will display the directorys parent, if it has one. When you click
the right mouse button on the hidden parent button, directory opus will
display the root directory.

Window view sliders:

Once the directory has been read in, it is displayed in the directory
window. There is a limited space on the screen, however, so the whole
directory may not be visible at once. A pair of sliders extends your
view of the window. In the centre of the two directory windows are
two vertical window view sliders. You can slide these up and down,
to scroll through the contents of the directory.

to slide the vertical window view sliders, press the left mouse button
on the black bar and, while holding down the mouse button, move the mouse
up and down.

Click above or below the solid bar for the slider to move one page in
that direction.

At the bottonm of the two vertical window view sliders are arrow buttons.
These will move the slider one line in either direction when clicked
upon.

Click and hold the left mouse button on one of the arrow buttons
for the directory to scroll through the window.

Press either the up or down cursor keys to move one line in that
direction. These too will scroll when held down.

Press the up or down cursor keys in conjunction with either shift key
to move a page in that direction.

Press a cursor key in conjunction with the ctrl key to display the top
or bottom of the directory.

To scroll quickly to the first entry starting with a particular letter,
press that letter; the directory will scroll as close as it can get to
the first entry whether file or directory starting with that letter.

Press a letter in conjunction with either shift key to scroll only
to the first file begining with that letter.

Whether or not the entire directory fits in vertically, it will definitely
not fit in horizontally. There is more information available for entries
than just the filename. Also displayed is the size in bytes, the protection
bits assigned to that entry, the date that entry was last written to the disk,
and any comment that may be assigned to that entry.

Horizontal window view sliders can be seen at the bottom of the directory
windows, with arrows at the inner ends. These work like the vertical window
view sliders, including the keyboard equivalents. you can scroll up and
down, and left and right, by holding the right mouse button and moving the
mouse.
The directory windows are usually the same size. If you want to see more
information than is displayed in the windows you can stretch the divider
between them left or right to resize them.
There is a hidden size bar between the two vertical window view sliders.
when you click and hold this button, the size bar will appear. While holding
the mouse button, move the mouse left or right. When you have the window
as you want it, release the button.
There three shortcut keys for resizing the directory windows:

 - slides the window view sliders to the far left

 \ slides them to the far right

 = re-centres the window view sliders

Next and previous buffer buttons:

Directory opus maintains up to 100 directory buffers for each directory
window.
To move back and forth through the buffers, click on either the previous
buffer button or the next buffer button. The buffer will be displayed
without re-reading the drive. The keyboard equivalent alternative is to
press the alt key in conjunction with the left or right cursor key.
To activate the directory field, press the return key.
To re-read the directory, press the return key twice.

1. 5. 4 Custom Buttons:

There are default custom buttons, all of which have left mouse button
functions. Some of the buttons are also configured to perform right
mouse button functions.
The custom buttons with right mouse button functions are indicated
by a dog-ear in the upper right corner of the button.

Important:

Many of the custom buttons perform actions on the selected files in
the current directory window. before clicking on a custom button,
verify that the idtended directory window is active. novice directory
opus users can be confused when they have clicked on a custom button
in an inactive window, and it does nothing. Of course you should verify
that the selected files and directories within the directory window
are the ones you wish acted on.

All:

The all button selects all entries in the currently active directory
window

Toggle:

Selecting all with the right mouse button will toggle or reverse
the state of all entries. This causes selected entries to be deselected
and deselected entries to be selected.

None:

The none button deselects all entries in the currently active directory
window.

Parent:

The parent button reads the parent directory of the directory open
in the active directory window. If the parent directory is contaoned
in the windows buffer list, it will be displayed without re-reading
it.
When the current directory is an assignment, for example c: , the assignment
will be expanded, and then the parent function will move to the parent
directory of the assigned directory.

Root:

The root button reads the root directory of the active directory
window. as with the parent function, the buffer list will be searched
before the parent directory is re-read.
When the current directory is a sub directory to an assigned directory,
the root function will display the assigned directory. When the current
directory is an assigned directory, the root function will display the
root drive of the assigned directory.

Copy:

The copy button copies the selected file to the destination
(inactive) directory. If any directories are selected to copy, the sub
directory filter will be used to determine which files will be copied.

Copy as:

The copy as function is similar to copy except that the entries are
copied to the destination directory using new names that you specify.
Wildcards can be used here.

Move:

This function will move all selected entries from the source directory
to the destination directory. The entry will no longer exist in its
original place. If any directories are selected to move, the sub-directory
filter will be used to determine which files will be moved.
Be careful with this function. Directory opus will delete the file if
you are moving it to a different device.

Move as:

Move as allows you to give each entry a new name before it is moved.

Rename:

Rename allows you to give new names to all selected entries in the
active directory window. A requester will appear for each entry in
turn, asking for the new name. The initial rename requester has two
string fields instead of one. You will usually just edit the name
in the lower of the two to the new name.
A limited type of wildcard rename is possible. entering a * in the
bottom field allows you to add prefixes or suffixes. For instance,
entering *. pic will add a . pic suffix to all selected entries.
entering a* will add an a prefix. Only one * may be used in this
process.
You cannot give a file a name that contains a *.
If you enter a * in the top as well as the bottom field, you can
replace sections of the name. for example, entering *. pic in the
top field and *. iff in the bottom field will replace the . pic
suffix in any entry that has one with a . iff suffix. if an entry
does not have a . pic suffix, it will be untouched. The * may also be
embedded. For instance, renaming foo*baz as gee*wiz would rename
foobarbaz as geebarwiz. Again, only one * may be used in each of the
string fields.

Clone:

Clone allows you to make a copy of selected entries in the same directory,
but with different names. A requester will appear for each entry, asking
for the new name.

Delete:

Delete will delete all selected entries in the active directory window
be careful with this, as it is easy to wipe out valuable data if you
are careless. Directory opus`s default configuration brings up a
requester before deleting. Nevertheless, you should always double
check the selected files before clicking this button.

Makedir:

Makedir allows you to create a new sub-directory in the active
directory window; its name is limited to 30 characters. A configuration
option, create icons with directories, can be used to create an icon at
the same time. The name of the directory is limited to 25 characters
if create icons with directories is enabled.

Assign:

Assign allows you to create an amigados assignment to the directory
in the active window. The assign command gives more examples.

Check Fit:

The check fit button tests whetheer the selected file will fit on
the destination drive. The screen title bar will display the number of
bytes needed, the available space, and the percentage of the file which
will fit on the destination drive.

Getsizes:

The getsizes button causes any selected sub-directories to be scanned.
The scanning calculates the total size, in bytes, of all files contained
in the sub-directory. Once scanned, the sub-directory will be displayed.
If a sub-directory has been previously scanned, it will not be rescanned
when you select the getsizes button. See clear sizes below.
The getsizes button also displays in the status bar the number of files,
directories and bytes that have been selected out of the total number
of files, directories and bytes. If there is enough space for the total
selected bytes on the disk in the destination directory window, all
selected files would fit on the destination disk if they were copied
and a y will be displayed after the count. If they won`t fit an n will
be displayed.
If you select an operation which causes a sub-directory to be scanned
(e. g. copy, protect, hunt ect. ), the size will be displayed as though you
had performed a getsizes.

Clearsizes:

The clearsizes button will clear the sizes for selected directories,
but not for selected files.
If a sub-directory has been scanned already, pressing the get sizes
button will not work. It is possible that a previously scanned directorys
size is no longer accurate; ant application, including directory opus,
might have changed the contents of the sub-directory since it was last
scanned. To re-scan a sub-directory, the size must be cleared with the
clearsizes button.

Hunt:

The hunt button allows you to search all selected sub-directories for
a specified file or files. A requester appears asking for the pattern
to hunt for. You can use full pattern matching for this search.
If a file matching the pattern is found, You are asked if you wish to
enter the directory containing it, or to continue the search. If elect
to enter the directory, the directory will be read and then all matching
entries will be highlighted.
You can also select entire devices to hunt, using the device list feature
that is described later.

Search:

The search button allows you to search the contents of all selected
files, and the files within selected directories, for a specified string.
a requester appears asking for the string pattern to hunt for. Again, full
pattern matching is supported.
If a file containing the string is found, you are asked if you wish to
read that file, or continue the search. If you elect to read the file,
it will be loaded into the text viewer, and a search will automatically
be initiated for the string you want.
You can also select entire devices to search, using the device list
feature that is described later.
If any directories are selected to search, the sub-directory filter
will be used to determine which files will be searched.

Run:

The run button allows you to run each selected file in turn,
providing that the file is executable. It is simmilar to double
clicking on the files icon, or running it from the cli a requester
will appear, asking for any arguments (should you require any).

Execute:

If you select this button with the right mouse button, the file will
be executed as batch files. This has the same effect as running the
batch file via iconx ( refer to amigados manual), or executing it
from the cli.

Comment:

The comment button allows you to add comments to all selected entries,
or to edit existing comments. The maximum length of a comment is 79
characters. If any directories are selected to comment, the sub-directory
filter will be used to determine which files will be commented.
You will be prompted for a comment for each selected entry. If you
wish to attach the same comment to all entries, you should select
the all button.

Datestamp:

The datestamp button allows you to change the datestamp of the selected
files and directories in the the active directory window. When you
select directories, You are asked whether you wish the files within them
to have their datestamps modified also.
If any directories are selected to datestamp, the sub-directory filter
will be used to determine which files will be datestamped.
For each entry, you are presented with a requester. If you wish the file
to have its datestamp set to the current date and time, simply press return.
otherwise, enter the date and time you want.
To set the datestamp of all selected entries you should select the all
button from the datestamp requester.
Choose okay or press return to set the datestamps one file at a time.

Protect:

The protect button allows you to modify the protection bits of the
selected files and directories in the active directory window.
When you select directories, you are asked whether you also wish
the files within them to be protected. for each entry, you are
presented with a requester displaying the protection bits currently
set for that entry. This is described in greater detail in the next
chapter.
If any directories are selected to protect, the sub-directory filter
will be used to determine which files will be protected.

Icon Info:

The icon info button brings up the directory opus info requester
for each of the selected files.

Add Icon:

Addicon allows you to add icons to all selected entries in the
active directory window. Directory opus will automatically sense
what type of file it is and add the appropriate icon (drawer,
tool or project). Default icons are used unless you have specified
the name of your own icons within the configuration (described
later).

Arc Ext:

This button allows you to extract files from an archive file.
Directory opus comes configured for arc, zoo, lharc files.
When you click on this button, the files are extracted from the
selected files and copied into the destination window.

Note: directory opus distribution disks do not include the
actual archive programs arc, zoo and lha. because they are
shareware, we are not allowed to distribute them. They are
available free on most bulletin boards.

Encrypt:

Have you ever had files that you wanted to encrypt so that
only people who knew the password could understand them?
This function allows you to do just that. It will encrypt
all selected files, using the password that you enter, with
a complex algorithm that most people will find impossible to work
out. The resulting files are not written over the originals, but are
instead written to the destination directory. They will be the same
size as the original files, so you can ensure you have enough room in
the destination directory.
To decrypt a previously encrypted file, you should enter the same password
preceded by a minus sign. For example, to decrypt files you encrypted
with the password foo, select the files, choose the encrypt function
and enter -foo as the password.

Read:

The read button allows you to read selected files. The name of
the file is displayed at the bottom of the screen. You can use
the slider and cursor keys to move through the file. Buttons along
the bottom move up and down by a page, move to the top and bottom,
allow you to search for text, and print the file. Pressing the right
mouse button or the q key quits the text viewer.

ANSI Read:

The ANSI read button brings up the same reader as read except that it
handles the special ANSI control sequences.

HEX read:

The HEX read button will read the selected files in the same way as
read, except in hexadecimal format. This allows you to view binary
files and other files containing non-text characters.

Show:

The show button is very versatile indeed. It will display iff ilbm
pictures and brushes, animations, workbench icons and fonts.
If the file is an iff ilbm, it will be displayed using information
from the file. Directory Opus will show most pictures and brushes,
including overscan, extra halfbrite (ehb), ham (4096 colour)pictures,
dynamic hires pictures created by macropaint, and aga 8 bit pictures.
The following keys can be used when viewing a picture or animation.

Tab                        Cycle Colours

Cursoor Keys               Scroll

Mouse Pointer              Scroll

Shift Cursor Keys          Scroll by page

CTRL Cursor Keys           Scroll to end

 .                         Mouse pointer on/off

 [                         Display in 4 bit format

 ]                         Display in 8 bit format

ESC or Right mouse button  Abort

Q or Left mouse button     Next

Space, Help or P            Help and print requester

These keys can be used when viewing an Animation

 S                         Starts and stops

 N                         Next frame

 -                         Slow down

 =                         Speed up

 \                         Original speed

 f1 - f10                  Various speeds (f1 fastest)

The show routine will also display Icons. If the file has a . info
suffix it is assumed to be an Icon. If the icon has an alternative
image, press return to toggle between the two.
To display a font, you need to enter the actual font drawer, and
select the size file (that is, the file 8, 12, 19, etc), not the
. font file.

Play:

The play button plays the selected files as sound files. If the file
is an 8svx format iff sampled sound (of the type generated by audio
master, for instance), the speed and other information from within the
File will be used. This button will play any file, and if the file is
not 8svx, it will assume a speed of 10000 samples/second.
Using the inovamusic. library, the play button also plays star/sound/
noise/protracker, med, octamed, octalizer, and med with midi modules.
Each file is played once only. to abort a sound while it is playing,
press the left and right mouse buttons.

Loop Play:

If you select this button with the right mouse button, the sounds
are played continuously (looped). To advance to the next sound, you
must press the left mouse button.

Edit:

The edit button allows you to edit any selected files, using the text
editor (or word processor) specified in the configuration.
The custom button configuration is explained later. By default, it
is configured to use commodores c:ed program. You will probably want
to alter this configuration to use an editor of your own choosing.

New File:

The new file button prompts you for a file name.
If you select this button with the right mouse button, you will be
asked for a filename to create a new file.

Print:

The print button brings up a requester which allows you full control
of print formatting.

1. 6 The Tiny Buttons:

The Directory Opus screen has several buttons that are not configurable;
they activate the most necessary and usful functions, and are included
so that these functions are always available, whatever your configurations
may be. If you had mistakenly configured directory opus so that no button
or menu called the configuration program, you would never be able to run
the configuration program to change this!
These buttons are called the tiny buttons, as they are much smaller than
the configurable buttons on the screen. Four of them are arranged in a
square approximately at the centre of the screen. Six others are found
in the bottom right-hand corner of the screen. They all have one character
titles.

B Buffer list:

This activates the buffer list function. This function displays a list
of all the directories contained in directory opus` internal buffers.
You may then double click on one of the displayed buffers so as to
jump to that buffer immediatly, rather than clicking the arrows to
cycle through the buffers one by one.
Pressing the right mouse button over the buffer list button will
activate the clear buffers command which clears from memory the
contents of all buffers except the two that are currently displayed.

R Reselect:

This activates the reselect function. This Function will reselect all
entries that were selected before the last operation was initiated.
The entries are reselected only if they still exist, and regardless of
whether the buffer containing them is currently displayed.
Pressing the right mouse button over the R Reselect button performs
the rescan function on the active directory window.

S Select:

This button activates the select function. This allows you to
select files and directories in the active directory window using
wildcards. All standard wildcards are supported ( *~? etc) as
well as the amiga dos wildcards hash ? and ?.
Pressing the right mouse button over the file select requester button
will activate the get devices function (the device list function). This
function produces a list of all devices, volumes and logically assigned
directories that exist in the system.

A Arexx:

This activates the arexx function, which allows you to launch an arexx
script or execute an arexx command from within directory opus.
Pressing the right mouse button over this button will activate the dirtree
function (the directory tree function). This function scans all sub-directories
in the currently displayed directory, and produces a tree structure.

The Tiny Bottom right Buttons:

These buttons are optional; if you dont want them you can make them
disapear by deselecting the bottom right tiny buttons flag on the
config/screen/general configuration screen.

? Help:

This button activates the help function. provided a help file has been
loaded, selecting any button or menu after enabling the help mode should
result in the appearance of some helpful text.
Note:- the highlighted question mark indicates the help mode is active.

E Error Help:

This activates the errorhelp function, which gives you more information
about dos error codes than is generally available.

F Sub-Directory Filter:

This button activates the sub-directory filter. When you click on this
button, a requester will ask you to enter a file filter. The filter can
contain a file specification containing wildcard characters. When you
click the okay or press return, the requester will disappear and the F
button will be highlighted. This indicates the filter is activated.
When the filter is activated, any command which processes the files
in selected sub-directories will only act on files which match the
filter.
These Commands are:-

Copy:

Copy as:

Move:

Move as:

Hunt:

Search:

Protect:

Datestamp:

Comment:

If the F Button is highlighted, you can turn off the filter by
clicking on it again. It will become un-highlighted.

C Configure:

This activates the configure function, and will either load into memory
or invoke the configuration program.

I Iconify:

This Button activates the iconify function. It closes the directory
opus screen, de-allocates as much memory as possible, and then opens a
small window on the workbench screen.
This allows you to have Directory Opus constantly available, while using
the minimum amount of memory possible.

Q Quit:

This activates the quit Function, which allows you to exit Directory Opus
(providing there is not a print operation under way). If the Configuration
has been modified and not saved, you are asked if you wish to save it first.

1. 8 Default Menus:

Directory opus has 100 user-definable Menus. The functions chapter explains
more about the menus, and the function editor chapter explains how to
configure them. This Chapter simply gives a brief description of the
default menus. All the menus can be changed, but they are configured
initially for certain functions.

1. 8. 1 Project Menus:

Project/Set Date:

This Function allows you to set the system time and date, especially
if you do not have a battery-backed clock. After you have set the time,
the Amiga Clock keeps running to provide an accurate timekeeper. All files
or directories created will have a datestamp of the current system time.
The datestamp command of Directory Opus uses the system time.
Two requesters will appear; the first containing the current date, and
the second containing the current time. To change either the date or the
time, delete and enter a new one. the date is expected to be entered in
the form dd-mmm-yy. for example, 22-sep-89. Time is expected in the form
hh:mm:ss, as in 18:30:43. You must include the dashes and colons as
demonstrated above.

Project/Current Dir:

This Function allows you to set the current working directory for
Directory Opus. The current directory is the directory loaded when
you activate either directory field, delete the existing pathname
(if there is one), and press return on a blank string.
A requester will appear, containing the pathname of the active directory
window. If this is acceptable as the new current directory press return.
Otherwise, edit it to read as you wish.

Project/Help:

Provided a help file has beed loaded in, selecting any button/menu
after enabling help mode with this menu should result in the
appearance of some helpful text.
Help can be read from any file, although the default is s:DirectoryOpus.hlp.
the file name can be changed with the helpfile configuration option,
described later.
The help file chapter describes the help file in detail, and explains
how you can edit it to add help for your own buttons and menus.

Project/Error Help:

Error help gives you information about dos error codes. When you select
this option, you are asked for which dos error code number you want help.
Examples of dor error codes are 123, 205 and 225. You are then presented
with a description of that error, and information pertaining to the
possible cause and cure of the error.
Error Help is also stored in the help file (see above); if the help file
has not been loaded, error help will not be available. See the help file
chapter for more information.

Project/Configure:

Directory Opus uses a separate program to modify the configuration.
This saves about 127k of memory, as the configuration program need only
be in memory when it is being used.
If you have plenty of memory, directory opus can be configured to load
the configuration program on startup. In this case, it is run from memory
each time the configure function is invoked, rather than loaded from disk.
This can be much faster, especially if you have a floppy based system.
see the configuration program chapter for more detailed information.

Project/About:

This Function displays some information about this program.

Project/Tech Support:

This menu displays information about getting technical support.
Please refer to the requester before contacing inovatronics as
there are specific times and methods for getting technical support.

Project/Version:

This menu displays the current version of kickstart, workbench
and Directory Opus. This information will be necessary when getting
technical support.

Project/Iconfy:

This Function closes the Directory Opus window and screen, de-allocates
as much memory as possible, and then opens a small window on the workbench
screen. This is known as iconifying, and allows you to have Directory Opus
constantly available, while using the least amount of memory.
The iconifed window may contain a clock, or may not be visible at all,
depending on how you have set the iconify type configuration option
(described later).
To determine the initial position of the iconified window (especially
if you plan to start up Directory Opus in the iconified state), you should
iconify directory opus, and position the window as you would like it
to appear. That done, re-enter directory opus, and save the configuration
(described later).
When iconified, you can drop workbench icons on the directory opus window.
This will have the same effect as if you displayed the file in a Directory
Opus window and double-click on it. for example, if you drop a picture
on the window, it will show it.
To re-enter directory opus, click the left mouse button in the iconified
window, then press the right mouse button. If you wish to quit Directory
Opus without going back into it, click the close button at the far left
of the iconified window.
Note that if you have the configuration option iconify type set to
hidden, the only way to re-enter Directory Opus is with the hotkeys.
These default to ctrl-shift-alt (the ctrl key, the left shift key and
the left alt key simultaneously), although this may be changed in the
configuration (explained later)

Project/Burron Iconify:

This causes a special variation of directory opus iconification.
normally iconification is set up by the configopus/system/clocks
screen, but with this commandyou can iconify directory opus into
a bank of buttons on worbench. In this Mode Directory Opus allows
you to do almost all, if not all it normally does. For instance, if
you select the copy button a requester will open asking you to
select something to copy followed by another asking where to
copy it. You can also use the bank of buttons as an appwindow
when running in os2. 0. To show a picture, you would simply drag
the icon of the picture onto the show button.
The slider to the right of the button bank allows you to choose
which button bank is shown.
To un iconify back to Directory Opus, press the uniconify button
above the slider to the right of the bank. Or select the close
button of the window. The close button will you wish to quit
Directory Opus or uniconify it.

Project/Quit:

This function will exit Directory Opus (providing there is not a
print operation happening at the time). If the configuration has
been modified and not saved, you are asked if you want to save it
first.

1. 8. 2 Function Menu:

The function menu contains miscellaneous disk operations, and
archive adding.

Function/Disk Copy:

This function brings up a requester which allows you to make an
exact copy of one disk on another. For more information, see disk copy
requester later.

Function/Format:

This allows you to format a new disk. All new disks need to be
formatted before the computer can write files to them.
For more information, see the format requester later.
When this is selected, a requester with several buttons appears.
Drives df0: to df3: are available. Separate names may be specified
for each disk.
Verify allows you to turn verify on or off. As with function/disk copy,
the process is faster with verify turned off, but you wont be made aware
of any errors, so its better to leave verify turned on if you dont
completely trust your disks.
If quick is selected, the disk will just be initialized (wiped). This
provides an extremely fast way to erase an old disk. This will not work
on new disks, however; only on disks that have previously been formatted.
If no icons are selected, the disk. info, trashcan. Info and trashcan
directory will not be created on the disk.

Function/Install:

This function brings up a requester that allows you to make a disk bootable.
To be bootable, disks must have special information written on their
first sector. For more information, see the install requester later.

Function/Relabel:

This function allows you to change the name (label) of the disk that
is open in the active directory window.

Function/Print Dir:

This function allows you to print the directory in the active directory
window. You are able to choose the information you want to print (file
sizes, protection bits, dates and comments). This function is not started
as a separate process, unlike the print command. For more information,
see the print dir requester later.

Function/Disk Info:

This function displays some information about the disk the active
directory resides on, including space used, space free, datestamp and
number of errors on the disk.

Function/lha add, arc add, zoo add:

These functions allow you to create and add files to arcives, using
the popular archivers arc, zoo and lha or lharc (and up to three others;
see the functions section of chapter 7 for more information).
To add files to an archive, select the files you wish to add, and select
this function. You will be asked for the name of the archive to create
or add to. You should have the destinaion directory open in the inactive
window.



                              Chapter 2


Requesters and Viewers:

This chapter presents the more complicated requesters and viewers.
Each of these is associated with Directory Opus commands which are
activated by custom buttons and menus.

2. 1 Protection Requester:

The protection requester allows you to change a files or a sub-directorys
protection bits.
The protection bits are a group of flags that are stored with the file,
that determine the characteristics of the file. These flags are given
one character names. The protection bits currently in use are hsparwed.

H: Hidden.
If this flag is set, the file is not normally displayed.
This allows you to mark certain files as "invisible", to avoid
cluttering your directories. The file can stillbe accessed normally,
and not all programs implement this flag.

S: Script.
A script file is a file containing a list of amigados commands
to execute; it is like a simple computer program. This flag indicates
that the file in question is a script file. A script file is sometimes
called a batch file.

P: Pure.
If a program file is flagged as pure, it can be made to remain
in memory, even when not in use. This can save a great deal of time,
especially if the program is not used a lot, as it does not have to
be loaded from disk each time.

A: Archive.
This flag indicates that the file has not been changed.
If this file is ever written to, the a flag will be turned off. This
can be used in a hard disk backup program, to record which files have
been backed up, and need not be backed up again.

R: Readable.
If this flag is set, the file can be accessed.

W: Writeable.
If this flag is set, the file can be written to (i. e,
more information can be stored in it than is already there).

E: Executable.
If a program file does not have this flag set. It can not be run.

D: Deleteable.
If this flag is not set, the file can not be deleted.

While AmigaDos and other programs do not fully support all of these
bits, Directory Opus gives you access to all documented protection
bits. As AmigaDos is enhanced, some bits, such as writable, will become
more usful. If you have additional questions about the usage of the bits,
refer to your Amiga documentation.
There is a button for each protection bit along the left edge of the
requester. Clicking on each of these will toggle a checkmarrk on and
off within the button. When the checkmark is on, it means that the bit
will be set when you click on the okay button.
In the middle of the requester are four buttons which manipulate
multiple protection bits at a time. These buttons do not cause any
action to take place within the selected files; they simply change
the state of the protection bit buttons.

All Bits:

Sets all proction bit buttons.

None:

Causes all protection bit buttons to be cleared.

Toggle:

Sets all clear protection bit buttons, and clears all set protection
bit buttons.

Revert:

Restores the protection bit buttons to the settings they had when
you entered this requester.
On the right side of the requester are three groups of protection bits:
old, new, and mask. Each group contains a protection bit letter or a
"-" (dash) for each bit. The letter indicates that the associated
protection bit is set, a dash indicates that it is clear.
The old group indicates the original bits when you entered the requester.
The new indicates the current status of the protection bit buttons.
Whenever you click the protection bit button, it will be reflected in
the group.
Unlike the previously described old and new groups, the mask group bits
can be changed by clicking on the associated letter or dash. The mask
group allows you to specify protection bits which should not be modified,
regardless of the protection bit buttons. When the letter is shown, the
bit will not be modified. The dash means that you need to set the bit
according to the setting of the protection bit button. This is most
usful when changing files within a sub-directory or using the all button
(described below). For example:you want to set the archive bit in all
files contained in a sub-directory, but you dont want to affect any of
the other protection bits. Set the archive protection button on the
left side of the requester and set all the archive bits in the mask
group except A. This will preserve all the files bits with the exception
of the archive bit, which will be set.
Along the bottom of the requester are three buttons:

Okay:

Causes the current file (shown in the screen title bar) to be set
as indicated in the protection bit buttons (and possibly filtered
according to the mask group).

All:

Causes all selected files to be set, without additional prompting,
as indicated in the protection bit buttons (and possibly filtered
according to the mask group).

Cancel:

Aborts the protection function.

2. 2 Disk Copy requester:

This function allows you to make an exact copy of one disk on
another. When this function is invoked, a requester with several
buttons appears.

From:

This list contains the possible disk drives that may be used as the
source. When you click on one, it becomes the selected drive.

To:

This list contains the possible desitnation drives which are
compatible with the selected source drive. The source disk drive is
always available as a destination to allow you to make single drive
copies. This only makes sence with removable media such as floppy drives
as it would accomplish nothing yo copy a hard drive to itself.

Verify:

This button allows you to turn off the integrity verification when
writing data to the destination drive. Although it is faster, you
probably wont want to do this.

Bump Name:

This button allows you to chance the volume name using the same naming
convention as workbench`s diskcopy. (See AmigaDos documentation for
details. )
This function will not copy any procted software, or non-amigados format
disks.
Selecting the diskcopy button will start the copy. The exit button will
abort without attempting a diskcopy.

2. 3 Format Requester:

This allows you to format a new disk. All new disks need to be formatted
before the computer can write to them.
When this is selected a requester with several buttons appears. On the
left side is a list containing the devices which can be formatted
using this operation.
Warning! this option will destroy existing data on a disk. Be sure you
want to erase the data before you click format or quick format buttons
the list on the left side of the requester conains the devices which
you can format. The selected device is highlighted. Be sure the device
you intend to format is the one that is highlighted!

Name:

This field allows you to give the drive to be formatted a volume
name.

Fast File System:

This allows you to format a device using the fast file system option
of AmigaDos. You should consult AmigaDos documentation for more detail.
this option does not work on floppies prior to os2. 0.

Intrenational Mode:

This allows file and directory names to include accented characters.
OS2. 1 and later.

Directory Caching:

Directory caching mode will decrece the capacity of your disk but the
directory reading speed will be mush greater.

Put Trahscan:

This button allows you to put a trashcan in the root directory of the
newly formatted device.

Verify:

This button allows you to desable the format verification. as with
function/disk copy, the process is faster with verify turned off,
but you wont be made aware of any errors, so its better to leave
verify turned on unless you completely trust your disks (you really
shouldnt).

Format:

This button begins the formatting process. Be very careful you have
selected the correct device. Once a format begins, it can be aborted,
but data will be lost.

Quick Format:

When this button is selected, the disk will just be initialized
(wiped). This provides an extremely fast way to erase an old disk.
This will not work on ner disks, however; only on disks that have
previously been formatted.

Exit:

This button will abort without attempting a format.

2. 4 Install Requester:

This function allows you to make a disk bootable. to be bootable,
disks must have special information written on their first sector.
the list on the left contains the possible devices on which you can
install a boot sector. Select the possible device you want to install
on. When you select a device (or insert a new disk in the device), Directory
Opus will examine the boot sector and inform you of the disks current
status. It does this automatically when you first bring up the install
requester. It will tell you one of the following:

No Disk Present:

This simply means that you havent inserted a disk in the drive yet.
when you do so, it will update this status message.

Normal 1. 3 OFS Bootblock:

This means the disk was installed with the old file system used before
2. 0 of AmigaDos.

Normal 2. 0+ FFS bootblock:

This means that the disk was installed with the new file system used
for 2. 0 and later versions of AmigaDos.

Non Standard:

This means that the disk is corrupt. It may contain a virus and it would
be a good idea to run a virus checker program to make sure.

Fast File System:

This button allows you to istall a fast file system bootblock.

Install:

This button installs the boot sector on the disk.

No Boot:

This button removes the boot sector from the disk. This will keep
the disk from being bootable. however, you can always re-install the
boot sector by clicking the install button.

Exit:

This button will abort without attempting an install.

2. 5 Print Dir Requester:

This function allows you to print the directory in the active directory
window. If no files are selected, all files will be printed. however, if
only some files are selected, only those files will be printed.
You can select the information you want to print:file sizes, protection
bits, dates, comments, and file types. Directory Opus can only print the selected
information when it is being displayed in the directory window.

Output To:

By default, the output will be sent to the printer. however, you can redirect
the output to a file of your choosing.

Printer:

This option directs the output to the printer.

File:

When this option is enabled, output is directed to the file indicated
in the accompanying field,
Click on the magnifing glass next to the file field to use a file requester
to find the file name; otherwise type the name directly into the file field.

Print:

When you click on this button, Directory Opus will begin printing the
information. it is not started as a separate process, so you might have
to wait while Directory Opus completes printing the information.

Exit:

This button will abort without attempting to print the directory.

2. 6 Print Requester:

This requester gives you full print formatting control for text files.

Note:

All printers are not created equal. Some printers will ignore some of
these configuration options.
These configuration options work in accordance with the Amiga printer
preferences. The Amiga preferences may override these preferences or
simply make the output look silly. For example, you cannot use these options
to display more lines on a page than is specified in Amiga preferences.

There are several configuration items in the print requester:

Top Margin:

This field contains the line number where text should start. A top margin
of 1 starts on the first line and does not have any blank lines.

Bottom Margin:

This field contains the number of printed lines on each page. The top
margin lines are not included in this value. For example, a top margin
of 5, and a bottom margin of 60 the last line will be printed on line
65.

Left Largin:

This field contains the number of characters to skip before printing
each line.

Right Margin:

This field contains the number of printed characters allowed on each
line. The left margin characters are not included in this value. For
example, a left margin of 5 and a right margin of 70 will result in the
last printable character in column 75.

Tab Size:

This field contains the number of spaces to which a tab character is
equivalent. Directory Opus converts tabs to spaces and will insert the
appropriate number of spaces to create columns based on tab size.
For example, a tab size of 8 specifies tab positions of 8, 16, 24, 32, 40,
56, and 64.

Print Pitch:

This button cycles between pica, elite, and fine. These values specify
the size of letters to print. Your printer will determine the exact
dimensions of these values.

Quality:

This button cycles between letter, and draft. Some printers can be toggled
between letter and draft quality printing.

Eject Final page:

A check in this button enables a final form feed character after printing
the last page.

Configuration:

This button cycles between header and footer. The title, date and page
number. Buttons (described below) can be used with creating a header
or footer line for each page in the print out. When the configuration
button is header, these buttons affect the header line; otherwise, they
affect the footer line. By default, Directory Opus will not ceate a
header or a footer line.

Title:

When the checkmark next to title is on, a title will be generated.
By default, the filename will be the title. However, you can override
this by putting text in the title field. You can have different titles
in the header and footer lines.

Date:

When the checkmark next to date is on, the current date will be printed.
Usually this is enabled for either the header line or the footer line,
but not for both.

Page No:

When the checkmark next to page no is on, the page number will be printed.
Usually this is enabled for either the header line or the footer line,
but not for both.

Text Style:

This button allows you to modify the appearence of all the printed text
except the headers and footers. (Some printers do not support all of these
styles). Clicking on the text style cycle button allows you to choose
from the following options: normal, bold, italics, unlined (underlined),
dblstrik (double strike), and shadow.

Output to:

By default, the output will be sent to the printer. However, you can dedirect
the output to a file of your choosing.

Printer:

This option directs output to the printer.

File:

When this option is enabled, output is directed to the file indicated
in the accompanying field.
Click on the magnifying glass next to the file field to use a file
requester to find the file name; otherwise type the name directly into
the file field. (If you leave the field empty, the output will go to
the printer. )

Print:

When you click this button, Directory Opus will begin printing the
information.
This function will print all selected files, one at a time. If you
select only one file to print, the print routine will be started
up as a separate process, allowing you to continue working with
Directory Opus. To cancel this type of print, simply select the
print function again. A requester will appear asking if you want to
continue with the print or halt it. This requester will also appear
if you attempt to quit directory opus while a print operation is
in place, as you cannot quit until the print has finished.
Even if you abort a print, the printer may not actually stop for some
time. This is because most printers have buffers, some quite large ones,
which store data for printing and will need to empty themselves
before the printout will stop.

Exit:

This will abort without attempting to print.

2. 7 Text Viewer:

The name of the file is displayed at the bottom of the screen, giving
the current position within the file both in lines and as a percentage,
and also the total number of lines in the file.
Press the left mouse button to scroll through the file. press the left
mouse button to scrolling on or off. The direction and speed of the
scroll are governed by the position of the mouse pointer in the window.
The mouse pointer will become invisible while the text is scrolling.
No scrolling occurs if you have the mouse in the centre of the window.
To scroll forward, move the mouse down until the text starts to scroll
(providing there is actually more than one page of text). The further
down you move the mouse, the faster the text will scroll. This procedure
is reversed for backwards scrolling.
The buttons in the bottom-right of the screen also allow you to move
around the file. Most buttons will repeat if held down for any length
of time. (Each button uses the corresponding letter as a shortcut key. )

Up/Down Arrows:

Move up and down a line at a time.

U:

Moves up a page at a time.

D:

Moves down a page at a time.

T:

Moves to the top of the file.

B:

Moves to the bottom of the file.

Cursor keys:

Move up and down.

Cursor key+shift:

Moves one page at a time.

Cursor key+ctrl:

Moves to the top or bottom.

The current line and percentage values (in the middle of the bottom
bar)act as hidden buttons:click on them and a requester will allow
you to specify a new value. It will jump to the new location.

S:

Searches for a string. you can use full pattern matching.

P:

Prints the current file.

C key:

Prints only the current page. this has no button equivalent.

X or Q or ESC:

Leaves the text viewer.
You can also use the right mouse button to exit.

If you have selected more than one file, the next one will be read when
you exit. To exit without reading the next file, press the right mouse
button.

2. 8 HEX Viewer:

The hex viewer will read files in the same way as read, except in the
hexadecimal format. This allows you to view binary files and other files
containing non-text characters. The file is displayed in the following
manner:
The first value is the offset, displayed in hex. This the number of bytes
you are into the file. The next four values are each a four byte longword,
with the actual ascii representation at the end. Any non-text characters
are shown as a . character.

                               Chapter 3

                           Opus Configuration

                              (Configopus)

3. 1 Introduction:

The Opus Configuration utility is a powerful and easy to use instrument
for customizing Directory Opus precisely to your tastes. Do you want to
use an interlace screen? Eight or sixteen colours? Lots of buttons?
fancy buttons? Directories sorted by date, in reverse order? Instant
access to various assignments? With Configopus, these are but a few of
the myriad choices you can make.

Sophisticated though it is, the configopus utility is quick and easy
to use. This chapter is intended as a complete set of instructions for
users new to directory opus, and as a convenient reference for experienced
users.

Directory opus uses a separate program to modify the configuration.
this saves approximately 130k of memory, as the configuration program
need only be in memory when it is being used.
Not only that, but the configuration program can be run independently
of Directory Opus, if you are realy short of memory.

If you do have plenty of memory, however, Directory Opus can be configured
to load the configuration program on startup. In this case, it is run from
memory each time the configure program isinvoked, rather than loaded
from disk. That can be much faster, especially if you have a floppy based
system.

From within directory opus, you can startup configopus by clicking on
the small c button on the lower right or selecting the configure item
from the project menu.

From outside directory opus, you can start configopus by itself either
by double clicking on the configopus icon or starting it from a cli

3. 2 Configopus main screen:

On the Configopus screen there are several items of interest. At the top
of the screen you will see screen depth and help buttons and the screen
title bar.

Screen depth button:

Allows the user to push the screen behind the other screens opened.

Help Button:

Brings up help information. when you have questions about something on
the screen, try here first. If the help button does not answer your question,
then you can drag out the manual.

Screen title bar:

Describes the current screen. Doubles as the screen drag bar, which allows
you to drag the screen down and see the screen(s) behind the Configopus
screen.

The next set of buttons to look at are the subject buttons along the
left side of the screen. when you select one, the screen will change to
show that part of the Configopus.

Buttons:

Configure the custom buttons, allowing you to launch internal commands
and external programs.

Drives:

Configure the custom drive buttons.

Filetypes:

Configure the file classes and actions necessary for file recognition.

Hotkeys:

Configure the global hotkeys, allowing you to launch programs from anywhere
in the system while Directory Opus is active or iconified.

Menus:

Configure the custom menus, allowing you to launch internal commands
and external programs.

Operation:

Flags and settings that affect the way Directory Opus behaves.

Screen:

Modifies the characteristics and appearance of the Directory Opus
screen and graphic user interface.

System:

Additional items that affect the way Directory Opus interacts with
the operating system.

The last buttons on this screen are the okay and cancel buttons. these
allow you to say eitheer ok, lets use this setting and go back to
Directory Opus, or oops! Forget all that, and lets get out of here!

3. 3 ConfigOpus configure menus:

There are four menu items available on most screens in Configopus
that allow the user to control the configuration data. You can revert
to the default configuration, Load a configuration file or save the
current configuration. On the configopus screen these menus will allow
you to affect all the configuration data. When you select the open item,
you load all the configuration data from that file, replacing any changes
that you have made with this new data.
On the other screens in configopus, the open menu will only override
the information specific to that screen. For instance, on the custom
button screen only the custom button banks will be loaded from a
configuration file. This allows you to load banks of buttons that you
have defined in advance, so as to control the newtek video toaster, for
example, or some other application.

Default:

Reset to the factory default configuration settings.

Open:

Load configuration settings from a disk file. These banks will be inserted
at the end of the banks that you have already defined. If you are on
custom buttons, drives, filetypes, hotkeys or menus this will only load that
part of the configuration file. As an example, by using this, you can
inport custom button banks from someone elses configuration file.

Save:

Save the current configuration settings as the default.

Save as:

Same as save, but this allows you to specify a filename.

3. 4 Buttons/Manager:

There are 42 custom buttons, located at the bottom of the Directory Opus
screen. Each button can have a left and/or right mouse button event,
bringing the total number of custom buttons to 84.
The custom buttons are arranged in banks. There is only one bank of these
buttons by default, but the configureation program allows you to add
or delete as many banks as you want, which means that the number of
custom buttons is limited only by the available memory and your
imagination.
The button configuration screen displays the current button bank, with
the left mouse button events at the top and the right mouse button
events at the bottom of the screen.
There are ten buttons across the bottom of the buttons/manager screen.
the copy, swap and delete buttons stay selected if they have been selected
with the left mouse button. For instance, copy button will stay selected
to remind you that you are in copy button mode. When you want to leave
this mode, select copy button again. The below that work in this fashion
are: copy, swap and delete.

Next bank:

With this button you can cycle through the button banks. The current bank
number is displayed in the title bar of the screen. Select this button
with the left mouse button to move to the next bank.
Select this button with the right mouse button to move you back to the
previous bank.

New bank:

This button allows you to ceate a new bank of buttons. If you select
this button with the left mouse button, it will create an empty bank
at the end of the bank list. This bank will then be shown.
if you press this button with the right mouse button, the new bank
will be inserted before the current bank, instead of at the end of the
bank list.

Copy bank:

Use this to copy the currently displayed bank. A requester will appear asking
you to enter the bank number to copy the current bank onto. If the bank
number you enter does not exist then a new bank will be created, at the end
of the bank list. The current bank will be copied there.

Swap bank:

Swap bank allows you to swap the contents of the currently displayed
bank with those of another. A requester will appear asking you to enter
the bank number to copy to. If the bank number you enter does not exist,
the swap operation will be aborted.

Delete bank:

After asking for conformation, this button will delete the current bank.
If the current bank is also the only bank, you will be warned.

Copy button:

This button allows you to copy one custom button onto another.
select the custom button to be copied, then select a custom button
to copy it onto. To abort the copy, turn off the copy mode, select
copy button again, or select the custom button you are copying again.

Swap button:

This permits you to swap two custom buttons. It works the same way as
the copy custom button execpt that it simply exchanges the two custom
buttons.

Delete button:

After asking for conformation, this will reset all the data associated
with the custom button.

When in copy or swap button mode, the next bank button is still usable
and allows you to copy and swap custom buttons between banks.

3. 4. 1 Button manager menus:

The default or open.... menu items in the configure menu allow you to
import custom button banks from either the default configuration or
a configuration file from disk. These banks will be inserted at the
end of banks you have already defined.

There is an additional menu strip available on this screen. The button
rows menu allows you to configure the actual number of rows of custom
buttons that will be displayed at one time on the main Directory Opus
screen. You can choose from zero (no buttons displayed), one, two, three
or six rows. This will also affect the drive bank height.

To edit a custom button, make sure you are not in copy, swap or delete
mode. Select the custom button, and you will be shown the custom button
editor screen.

The last two buttons on this screen (lower right corner) are the okay
and cancel buttons. These allow you to say ok, lets use all these custom
button changes and go back to configopus main screen, or oops! Forget
all this, and lets just leave.

3. 5 Buttons/Editor:

At the top of the custom button edit screen you can see what the
current custom button looks like. The palettes on either side allow you
to select the buttons foreground and background colours. If you click
on the example button itself, it will highlight to show you what the real
button will look like when selected.

Name:

The name field allows you to modify the name that appears on the
button, and is limited to 63 characters.
The shortcut key displays the keyboard equivalent for this custom button

Sample:

To modify the shortcut key, select the sample button at the right of
the shortcut key field, then any keys you press, along with any qualifer
keys, will be inserted in the shortcut key field. To turn off sample
mode, select the sample button again.
To remove the shortcut key, select the sample button with the right
mouse button.

3. 6 Command editor:

A command tells Directory Opus what to do when somthing happens, and
can be attached to custom buttons, filetype actions, hotkeys and menus.
Each of these has its own configuration screen with unique aspects
(e. g. , the title and colours used on a custom button).

The unique aspects of the various editors are described in their own
sections, but they all have a common portion, referred to as the command
editor, which allows you to edit the command.

At the centre of the command editor is the command list which contains
the commands associated with this function. To the left of this list are
four buttons that allow you to modify the order and effectiveness of
these commands.

New entry:

Adds a new command to the list.

Duplicate:

To duplicate an existing command, select the command and select the
duplicate button. The duplicated command will be added to the end of
the command list.

Swap:

To exchange the position of two commands, select the first, then select the
swap button. With the swap button active, select the second command to swap.
To cancel the swap operation, select the swap button again.

Delete:

To delete a command from the list, select the command and select the delete
button.

To edit a command, simply click on it. The command string will be copied
to the fieldbelow the list for you to edit it.

3. 6. 1 Edit Fields:

Below the command list is a group of editing tools. These tools allow
you to edit active command entries. When you click on an entry in the
command list it becomes active, or an empty one is created when you
select new entry.

Command type:

The cycle button on the left below the command list allows you to
specify which kind of commond is used. When you click on this button,
it will cycle through the following command types:

Command:

Executable:

Workbench:

Batch:

Arexx:

Each of these command types is described below.

When you click on the magnifing glass button just to the right of the
command type button, a requester appears allowing you to pick an
appropriate entry for the selected command type. Each of the following
descriptions indicates the kind of requester which will appear.

Command:

These are internal commands, built into directory opus. many of these
commands can take parameters from buttons amd menus, as well as from
arexx. Internal commands are documented in the commands chapter.
The magnifing glass button brings up a list of internal commands.

Executable:

Executables are launched as if you were running them manually from the
cli. Thus, with an output window enabled, they can receive keyboard input
from the user and display output on the screen.

The magnifing glass button brings up a file requester.

Workbench:

Workbench programs are also executable programs. They are launched,
however. As if you were double clicking on their icons from Workbench.
this can be an advantage, as many programs do not take arguments,
or do not work at all if run from CLI.
If the workbench program given is a tool (i. e. , an executable program),
Directory Opus will look for its icon file to determine the necessary
stack size to give to the program. If the icon cannot be located, the
stack size defined in the button, menu or filetype will be used.
If the Workbench program is given is a project (a non-executable file
created by another program), Directory Opus will look for its icon file
to find its default tool, the actual program needed to load the file.
If the icon cannot be found, or a default tool can not be loaded
successfully, Directory Opus will not launch the file. The projects
icon is also used to determine stack size.

Workbench programs can also take arguments from Directory Opus using
the {f} and cimilar sequences. This can be very usful indeed. Deluxe Paint,
for instance, does not accept arguments if run from the cli; you would
be unable, therefore, to select a picture file for deluxe paint to load
from Directory Opus if you were running Dpaint as an executable.
if, however, you have the command defined as:

Dpaint {f}

and have the command type set to Workbench, Deluxepaint will be run as a
workbench program. from the Workbench, Deluxepaint will accept arguments, so
the first file you selected would be loaded into dpaint automatically

The magnifying glass button brings up a file requester.
whenever Directory Opus opens a command editor, it creates an appicon
on Workbench. The Directory Opus appicon looks like a normal icon, but
it does not do anything when you double click on it. However, if you
drop an icon on it, Directory Opus will add a Workbench command entry.

Batch:

Batch files, also called script files, are files that you might run with
the execute command, or with the execute command from the cli. Selecting
a command type as batch will cause the file to be executed as a script
file.
The magnifying glass button brings up a file requester. This file requester
is initially set to s: because this is where batch files come from by
default.

Arexx:

This type indicates that the command is an arexx script. This script
will only be launched if ARexx is active in the system. Note that the
address of the ARexx port will be set automatically; you do not need
to use the ARexx address command to address the command to Directory
Opus.
The magnifying glass button brings up a file requester. This file
requester is initially set to rex: because this is the place ARexx
files come from by default.

{}:

This button is located next to the command edit field. This button brings
up a list of the argument functions. Refer to the functions section of
the manual for more information about this powerful feature.
Function strings can contain many different command sequences to do
different things with files and directories. For documentation on these,
and more information on functions in general, consult the functions
section of the manual.

Flags:

Below the command list is the flags list. This is a list of all the
flags available for custom commands. These flags apply to all commands
in the command list. The flags are:-

Auto iconify:

Causes Directory Opus to enter iconified mode when the commands are
launched. This could be useful in low memory situations. It only works
with run asynchronously enabled.

Cd source:

If this is turned on, the current directory of the custom command will
be set to the current source directory (active directory window).

Cd destination:

This has a similar effect to cd scource, except that the current
directory of the custom command will be set to the current destination
directory (inactive directory window).

Directory Opus to front:

Causes the Directory Opus screen to be brought to the front when the
commands have terminated. It is used in conjunction with workbench to
front. If enabled in conjunction with run asynchronously and output
window, this flag will have a slightly different effect. In that case,
the output window will be opened on the Workbench screen as normal,
but the Workbench screen will not be brought to the front.

Do all files:

This causes the commands to act on each selected entry in turn, instead
of just the first entry. This is used for commands that do not support
multiple filenames on the command line, where {f} to send all selected
entries, would not work.

Include dopus-startup:

Has Directory Opus execute a file called s:dopus-startup before any
external commands are actually executed. This file is used in the same
way as the shell-startup file above, but it is distinct from the shell
startup file, and therefore allows you to put into it any Directory
Opus-specific commands.

Include Shell-startup:

If this option is enabled, then Directory Opus will execute the
standard s:shell-startup file before any external commands are
actually executed. This allows you to have all your path lists,
resident commands, etc. available to custom commands.

No file quote:

This option enables Directory Opus to operate correctly with some
older or poorly written software. Normally, whenever Directory Opus
sends a filename to a custom command with the {f}, {o}, etc. flags,
the filename is enclosed in quotation marks. This allows you to
use filenames containing space with external programs. However, some
software does not interpret the quotation marks correctly. If you find
this is the case with any program, simply select the no filename quote
flag.

Output window:

Opens a window for output from these commands. The window will open on
the Directory Opus screen, unless the Workbench to front option or the
run asynchronously option is enabled. In this case, it will open on the
workbench screen, and the Workbench screen will be brought to the front
automatically. The window is opened using the handle specified in the
System/Amigados section of the configuration.

Output to file:

Redirects all output from the commands to a temporary file in the t:
directory, which is then read via the text viewer. This allows you to
read the output of a program thoroughly, and even to print it. Note
that if you are sending output to a file, the command cannot receive
input from the keyboard.

Recursive directories:

Allows the command access to files within sub-directories. Normally,
whenever a {f} or {f} orsimilar sequence would result in the name of
a directory being included in the programs parameters, Directory Opus
would treat the directory in the same way as a file. In other words,
the command would not act recursively on all files within the directory.

If this option is enabled, the names of all files within that directory,
and within sub-directories within the directory, and so on, are included
in the programs parameters. This allows the command to act on all files
in the directory and not just on the directory itself.

Reload each file:

Causes Directory Opus to rescan a file after it has been acted upon
by a command, and updates the size, datestamp, comment and protection
bits of the file. You can therefore reflect changes in size, for instance,
made by a text editor to a file.

Rescan destination:

This flag makes Directory Opus reload the destination directory (inactive
directory window) when the command terminates. this, and the above option,
allows Directory Opus to display correctly any changes made to either
directory window by external programs, such as archivers.

Rescan scource:

Makes directory opus reload the scource directory (active directory
window) when rhw command terminates.

Run asynchronously:

Indicates that the commands are to be launched as a new process,
and Directory Opus is not to wait for it to return. If this is the case,
and an output window is specified, the output window opens on the
Workbench screen.

Workbench to front:

Causes the Workbench screen to be brought to the front.

Three fields at the lower right allow you to specify stack size, priority
and output window close delay.

Stack size:

The stack size is the size (in bytes) that external programs will use
as stack space. The default and minium is 4000 bytes. The documentation
of the program you are running should advise you of the best stack size
to use.

Priority:

The priority field allows you to determine the priority at which the
programs will run. The default is 0. You should not normally use anything
lower than -10 or higher than 10, execpt for certain programs (the
documentation of the program may advise you of appropriate priorities.

Close delay:

This field is the number of seconds after the commands have finished
before the output window closes (if one is specified). The default is
2, which means that the output window will close two seconds after the
commands have terminated. If you set the close delay to 0, the output
window will close immediately. If you set it to -1, it will wait for you
to press the left mouse button before closing.

3. 6. 2 Edit menu:

If you move the mouse to the top of the screen and press the right
mouse button, you will see that the main configure menu has been replaced
by the edit menu. The options in this menu operate on the currently
displayed command list. This includes the flags and fields.
All screens with a command editor contain the edit menu with cut, copy,
and paste functions. These allow you to swap function definitions
between custom buttons, menus and file types.

Cut:

Copies the settings of this command list to the clipboard then erases
them, resetting all fields to their default settings.

Copy:

Copies the settings of this command list to the clipboard, but will
leave the values untouched.

Paste:

Displays a list of all command clips in the clipboard (if there
are any present). If you select an entry from this list, it will be
pasted into the current command replacing any information that was
there already.

Erase:

Resets all fields to default settings, erasing the command list. The
command will not be copied to the clipboard.

Clear clips:

When you use the cut and copy edit menus, the commands are stored in
the file t:configopus. clip. Clear clips deletes this file causing all
previously clipped commands to be cleared.

3. 7 Drives/manager:

The drives button configuration screen allows you to configure the
drive buttons. These buttons give you quick and easy access to device
or directory. There are 30 drive buttons, arranged in five banks with
six buttons in each. The drives configuration screen displays all 30
drive buttons at the top.
There are ten buttons across the bottom of the screen. Some of these
buttons stay selected when selected with the left mouse button.
For instance, copy bank will stay selected, reminding you that you
are now in copy bank mode. To leave this mode, select copy bank again.
The buttons below that work in this fashion are: copy bank, swap bank,
delete bank, sort bank, copy drive and delete drive.

Get drives:

Causes to be assigned to the names of all the devices and assigned
directories (the first 30 present) in your system. You would normally
only do this when performing a major reconfiguration.

Copy bank:

Copies one drive bank onto another. Select any drive button in the
drive bank to copy, and then any drive button in the destination
bank.

Swap bank:

Allows you to exchange the contents of two drive banks. This works the
same way as the copy bank button.

Delete bank:

Erases the contents of a drive bank. If a drive bank has no buttons defined
in it, it will not be displayed on the main Directory Opus screen (i. e.
Directory Opus skips over unused drive banks). In fact, if you delete
all the banks, the drive banks will not even be shown on the main
Directory Opus screen. This allows the main custom buttons to be wider.

Sort bank:

Alphabetically sorts the contents of a drive bank. Select any drive
button in a bank and that bank will be sorted.

Copy drive:

Copies one drive button onto another. Select the derive button to be
copied, then select a drive button to copy it onto. You can abort the
copy by turning off copy mode, selecting copy drive again, or selecting
the copied drive button a second time.

Swap drive:

Swaps two drive buttons. This works the same way as the copy drive
button execpt that it exchanges the two drive buttons.

Delete drive:

After asking for confirmation, resets all the data associated with a
drive button.

The last two buttons on this screen (lower right corneer) are the okay
and cancel buttons. These allow you to say ok, lets use all these drive
button changes and go back to configopus main screen, or oops!forget all
this, and lets just leave.

3. 8 Drives/editor:

When you select a drive button from one of the banks, the drives editor
will appear or be updated with that drive buttons information. The drives
editor will be displyed directly below the drive banks.

Name:

This field allows you to modify the name that appears on the drive
button. The name field is limited to fifteen characters.

Path:

This is the actual Amigados path that is read in whenever this drive
button is selected. The path field is limited to 256 characters.

Shortcut key:

Is a display area for the keyboard equivalent for this drive button.

Sample:

To modify the shortcut key, select the sample button. While the sample
button is selected, any keys, along with any qualifiers, you press will
be inserted in the shortcut key field. To turn off sample mode simply
select the sample button again.
To remove the shortcut key simlpy select the sample button with the
right mouse button.

3. 9 Filetypes/manager:

A file is simply stored data. Files can contain executable programs,
iff pictures, icons for Workbench, or a multitude of other kinds of
data. Most (but not all) files have an identifiable structure. Directory
Opus filetypes system is designed to examine a files structure and
identify the kind (or type) of data it contains. You can configure
Directory Opus to understand an unlimited number of filetypes.

Filetypes are a versatile feature of Directory Opus. Using filetypes,
you can configure Directory Opus to play animations when they are
double clicked, to load a database program when you attempt to read
a database file, or to uncompress an archived file when you click m
click on it.
This is the essence of the filetypes:when you do something to a file,
Directory Opus can figure out what kind of file it is, and take the
appropriate action for that type of data.
There are two sections to the filetypes configuration:

Filetypes:

There is a list of filetypes which is searched when an action occurs.
If the file being processed matches a filetype, you can configure Directory
Opus to perform a specific action.

File classes:

There is a database of file class definitions: each describes the process
of matching a particular kind of file.
Directory Opus comes with more file classes than you will probably use.
You can select from this list when you are creating a new filetype entry.
you dont have to be an expert or know anything about the internal
structure of the file to do this.
The file class manager, described in the next section, allows you to
edit existing file classes, or define new ones. (This can be somewhat
more complicated. )

3. 9. 1 Filetypes:

The filetype configuration screen displays the list of filetypes that
Directory Opus recognizes. by default, it recognizes lha archive,
Arc arcive, Zoo archive, and Workbench icons.
There are five buttons across the bottom of the screen. Some of these
buttons when selected with the left mouse button stay selected. For
instance delete will stay selected indicating that you are now in
delete mode. To leave this mode simply select delete again. Both the delete
and swap buttons work in this fashion.

New:

This allows you to create a new filetype entry based on a predefined
file class. When you select this button a requester appears containing
currently defined classes. To create a new entry for one of these file
classes simply select it and you will be brought to the filetype action
editor (described below).

Swap:

This button allows you to exchange the positions of two filetypes
in the list. This can be very useful or even neccessary. In the case of
having two filetypes defined in which one is a sub-set of the other,
e. g. 24 BIT ILBM pictures vs regular IFF ILBM pictures, you would want
the 24 bit ILBM pictures to come first because they are a special case
of the regular IFF ILBM picture filetype. otherwise, pictures (in this
case) will be matched with the regular IFF ILBM picture filetype and
will never have a chance to match with the sub-set 24 bit ILBM picture
filetype.
To actually perform a swap, click on the swap button to enter that mode.
Click on the first filetype, then on the second. Those two filetypes will
exchange places in the list. To exit swap mode simply press swap a
second time.

Delete:

In this mode you can select filetypes to remove from the list. Click
on the delete button, then click on the entries you wish to delete.
If you accidentally delete an entry, click on the cancel button.

Okay and Cancel:

These buttons allow you to say ok, lets use all these filetype
changes and go back to configopus main screen, or oops! forget
all this and lets just leave.

To edit a filetype, make sure you are not in swap or delete mode.
Then simply select it. You will then be taken to the filetype editor
screen.

3. 9. 2 Menus:

There is an additional menu on this screen which controls file classes.
Please refer to the section on file class manager for information about
this menu.

3. 9. 3 Editing an existing entry:

To edit an entry in the list, simple click on it and you will be taken
to the filetype editor (described below).

3. 10 Filetypes/editor:

This editor allows you to define the actions taken on a matching
filetype. In a preceding section, you learned to configure an action
when a custom button is selected. Essentially, you say "when this button
is clicked do this. ". In the filetypes editor, you say:"when i do this
to this particular filetype do that. " The primary difference is that
a custom button can only be activated by being clicked on; the functions
available for editing filetypes can be activated in several ways.

Events:

At the top of the filetypes editor is a list of event types, which are
instructions you amy choose to directory opus regarding filetypes.
Each of these events is associated to either a mouse action or a
Directory Opus command, so each entry on the list is tagged either
action or command. An asterisk * indicates that entry already has an
event command list defined for it. Clicking on an entry in the list
highlights it to show that it is the command list currently being
edited. The current command list is displayed in the editing list in
the middle of the screen. The small field immediately above it describes
the event.
While each of these event types can be defined to do something, usually
only a few are actually defined. It certainly is not neccessary to define
all events for a filetype.
When one of these is activated, Directory Opus does the following:

It first searches the filetype list, starting with the first entry, and
checks whether it matches the entrys file class.

If it matches, it looks to see if the corresponding event is defined
from this editor. If it is defined, it performs the command list.

If it does not match the file class, or if it matches and does not
have a command list defined, it continues to search the filetypes
list. It is possible for it to match a subsequent entry that does have
a command list defined.

3. 10. 1 Mouse action events:

Mouse events occur when you either double click on a file or perform
a click m click.

Double click:

This occurs when you double clicck on a file. A popular use of this is
to examine a file (e. g. , show it if it is a picture or play it if it
is a sound). The actual double click speed is defined by the operating
systems preference program.

Clicl m click:

This event occurs when a file is clicked on then the mouse is moved
to the other window and clicked. One popular use of this event is for
archive extracting. Another way this event can happen is by using click
drag release. With this you literally drag a file into the window and
drop it there.

3. 10. 2 Command events:

Command events are called when a file is acted upon by a Directory
Opus command. For example, when a read command is performed on a file.
Directory Opus will search for a filetype which matches the file and
has a read event defined. You could, however, have read do something
special for an archive (i. e. list the contents of the archive).
Likewise if you have a music score you could define the play (or
loop play) to call up your player for that music score.
Each of the following command events is associated with a
corresponding Directory Opus command. This allows you to redefine the
specific action taken for a particular filetype. By convention you
should use a command event for something similar to its normal use,
but there is nothing to stop you from giving a command event a label
that is totally irrevelent to its use. Its up to you to keep the context
of the command (i. e. a read would would be confusing if it did a disk
format).
The following list describes the normal usages. You can decide what you
want it to mean for any given filetype.

ANSI read:

Fancy text viewer.

HEX read:

Binary or hexadecimal file viewer.

Loop play:

Normally associated with playing sounds in loops

Play:

Playing sounds.

Read:

Simple text viewer or viewing contents of archives.

Show:

Picture viewer.

User events:

The terms user1, user2, user3, and user4 may seem cryptic, but they are
here to give you flexibility. Each of the preceding commands has an
implied usage, but you may have an application which doesnt realy mean
any of these. In that case, you can decide that one of these user events
means "perform this special operation".
Directory Opus default configuration employs user1 for extracting from
archives.

Edit class:

The button to the far right of the list allows you to modify this filetypes
class definition. Ee will talk about editing file classes in the file class
section.

Below the list of events associated with this filetype is a field
describing this particular event. For instance you could have the read
event say something like "reading file... ". this message will appear
in Directory Opus title bar when the event is being performed.
The remaining part of this requester is described in the command editor
section.

3. 11 File class/manager:

File class management is handled by a menu accessible from the filetype
manager screen then offers management tools and storage optoins:

New:

Selecting this menu option allows you to create a new file class definition.

Edit:

This will open a requester showing you all the currently defined file
classes. To pick one to edit, simply select it; you will then be brought
to the file class editor. To abort press cancel.
Once you have made a filetype entry based on a file class definition
then you must use the edit class button on the filetype editor screen.
When you make a filetype, it uses a copy of the file class in the actual
filetype entry. This has several important results. once a filetype is
made, you can edit its file class definition without changing the original
definition. The edit class button on the filetype editor allows you to
do this. Selecting edit from the classes menu allows you to edit the
original file class definition. This will not automatically update any
filetypes which used the original definition. You can even delete the
original file class without affecying a filetype which used it.

Duplicate:

This allows you to create a new file class based on an already
defined file class.

Delete:

This will bring up a requester allowing you to select a file class to
clear from memory. Simply select the file class to delete and respond
yes to the confirming requester. Press cancel to abort deleting.

Open:

With this you can inport file class definitions from a file.

Save:

Save the current file classes to their default place on disk.

Save as:

Save the current file classes to a specific file on disk.

Clear:

Clear all file class definitions from memory.

3. 12 File class/editor:

Selecting new, edit, or duplicate from the filetype manager screen or
clicking edit class button on the filetypes editor brings up the file
class editor.
This screen is the most complex section of configopus. It even looks
scary, but dont worry: it is rather simple once you get to know it.
The best way to describe this screen is to start at the top and go
down from there.

File viewer:

The field at the top of the screen is simply a file viewer. To view
a file, type its name into the field or click on the magnifing glass
to bring up a file requester. The file selected will appear below the
field. It will be displayed in hex/ascii format similar to the hex read
command in Directory Opus itself.
You may wonder why we have a file viewer on this screen. We have found
that when creating a new file class definition it is usful to a way to
look at files, since you are trying to describe to Directory Opus a way
of identifying files.
To the right of the file viewer is a button that cycles from decimal
to hex. This button tells configopus in what format to display the
position and offset information in the two read-only fields below the
cycle button.
The simplest way to show how this all works is with an example. Select
the file c:ed (by either typing into the field or using the magnifying
glass file requester).
The format of the data in the fileviewer is as follows: the first column
is the address into the file we are looking at. The next four columns
are 16 bytes of data from the file in hexadecimal format. The last
column is simply those 16 bytes in ascii format. Where there is a byte
that is 00 or nul we display it in ascii as a period.
Position your mouse pointer over the "f3" characters and press the
left mouse button. A cursor will appear and the position read only
field will be filled with "000000003". This means that the cursor is
positioned on the forth byte in the file (remember byte locations are
zero relative, that is, first byte is at location zero). If you click
the cycle button above the position read only field and change it to
hex then the position will be filled in with "$00000003" which is
hexadecimal for three. You can move the cursor around in the file
with either the mouse pointer (simply select another place in the
file) or the cursor keys.
Now double click on those "f3"characters. This time the characters
change colours. They are now the position from which offsets are
computed. Move the cursor by pressing the down key a few times and
you will notice the offset read only field contains the offset from
the double click position.

3. 12. 1 File class editor

Components:

Thats about it for the file viewer part of the file class editor screen.
Now we go off to the real power house of Directory Opus.

File class:

The field below the file viewer is for the name of the file class.
This is for the name of the file class.

Class id:

The class id will appear beside the filetype in the filetype manager
screen and is a shorthand way for Directory Opus to write the name of
the file class.

Underneath the fields is the file class identification definition.
This is a series of actions that Directory Opus will perform in order
to identify a file class. The action may be as simple as matching a
filename to a pattern or as complex as scanning an IFF form looking
for data in a specific iff chunk.

Below the list is a magnifying glass, a read only field and an argument
field. These are used for editing the file class identification
definition.

New entry:

Creates a new entry in the file class definition script.

Duplicate:

Duplicates the current file class definition script line. The copied
line is inserted after the current line.

Swap:

Lets you swap the position of two file class definition script lines.

Delete:

Will let you delete the current line.

3. 12. 2 Editing:

To edit a line simply click on it, and the read only and argument fields
will be filled in. To change the command in the read only field, click
on the magnifying glass button and a list of other commands will be
displayed. Select the one you want or press cancel to abort.
The general structure of the file class definition script is that there
is a clause or a sequence of clauses that describe what should be
considered a matching file for a given filetype. There are only two
directives that delimit clauses:and and or. They are used to tell the
system what to do if a clause fails or succeeds.
When all the clauses are finished and the result is true then the file
is of the right type.

3. 12. 3 File class edit commads:

And:

If the preceding clause succeeds, then also do this clause; otherwise
skip to the next clause. If the preceding clause executed did not succeed,
then execution stops and the file does not match.

Or:

If the preceding clause fails then do this clause; otherwise skip to
the next clause.

3. 12. 4 Testing directives:

This states that a sequence of bytes starting at the current file offset
must match the given pattern. To match a single unknown chatacter when
text is given, use the ? character. To match a single unknown byte when
$HEX is given use two of them (??). You can also use \000 syntax to
specify ASCII characters by their decimal number. A \009 would be a tab
character, a \114 would be the lowercase r.

Example:

Match $000003f3 (executables start with these bytes)
Match form????ilbm (the way an iff ilbm picture starts)
Match hey\0090overthere ("hey"then a tab then "overthere")

Matchbits:

Match bits hsparwed

This tests the files protection bits. To see if a bit is set, put a +
before the character. To see if the bit is unset use the - .

Example:

Matchbits +rw read write must be on, others dont matter.
Matchbits -e  executable must be off, others dont matter.
Matchbits +rw -e read, write must be on and no executable.

Matchcomment:

Match comment text:

Simply compare the text given against the comment of the file.
Any valid amigados wildcard pattern is usable here.

Example:

Matchcomment silly_picture (file with silly_picture as a comment)
Matchcomment #?eddie#? (any file with eddie in its comment)

Matchdate:

Matchdate dates:

Test the date of the file against a date. For information about
datestrings or ranges see the select command later in the manual.

Example:

Matchdate 08-sept-92
Matchdate < 10-jan-92

Matchname:

Matchname filename:

The filename must match the character pattern given. Any valid Amigados
wildcard pattern is usable here.

Example:

Matchname #?. ilbm.
Matchname *. lzh

Matchsize:

Matchsize > or < or = integer:

Test the size of a file against a value.

Example:

Matchsize > 1000

3. 12. 5 Movement directives:

Moveto:

Moveto byte location:

Move to a specific byte offset from the begining of the file. Initially
you are always at the begining of the file, but you may have been moved
in a previous clause, so you might want to put a moveto at the begining
of a clause in order to know exactly where you are.

Example:

Moveto 0 (back to the begining of the file.
Moveto 100 (move to the 101st byte of the file)

Move:

Move byteoffset:

Move to a byte relative to the current file offset.

Example:

Move 16 (move sixteen bytes forward into the file)
Move -4 (move back four bytes from where we are)

Searchfor:

Searchfor text or $HEX.

Search (starting at the current file offset) for a certain byte pattern
that matches the given pattern. See the match command for valid options
for this directive. If the match occurs, then the current file position
will be the first character matched.

Example:

Searchfor cmap (look for the "cmap", position on the "c")
Searchfor m. k. (search for m. k. , position on the "m")

A failure of ant movement directives causes the clause to fail.

Example:

One example of usage is the field class 24bit picture.

Example:

Match form????ILBM (file must start with these characters)
and (if the previous cause is true then do the following)
searchfor bmhd (then search for the bmhd chunk id)
move 16 (moves sixteen bytes into the file)
match $18 (this must be 24 (or $18 in hex) to be a 24bit picture. )

We would suggest looking at the predefined file classes to get an
idea of the type of thing you can do with this system.

3. 13 Hotkeys/manager:

Directory opus can have an unlimited number of hotkeys defined.
hotkeys are systematic global key definitions. These keys are available
from every application you run, as long as Directory Opus is running
or iconified. If Directory Opus is busy doing somthing else (i. e. , copying
files etc. ) then the keys operation will start up as soon as Directory
Opus has finished. Under 2. 0, hotkeys are implemented via commodities and
are controlable via the commodities exchange program (see amiga 2. 0
manual).
There are six buttons across the bottom of the screen. Some of these
buttons stay selected when selected with the left mouse button.
For instance, delete will stay selected to remind you that you are now
in delete mode. To leave this mode, select delete again. The buttons below
that work in this fashion are: duplicare, swap and delete.

New hotkey:

Takes you to the hotkey editor so you can define a new hotkey.

Duplicate:

Duplicates a hotkey. you can abort the copy by simply turning off
duplication mode, selecting duplicate again.

Swap:

Allows you to swap the order of two hotkeys. Remember that the first
hotkey is seen first, so if you have two hotkey entries defined to the
same key sequence, only the first one will be seen.

Delete:

After asking for confirmation, this deletes hotkeys.

3. 13. 1 Menus:

The default or open menu items in the configure menu allow you to import
hotkeys from either the default configuration or a configuration file
from disk.
To edit a hotkey, make sure that you are not in duplicate, swap or delete
mode, then simply select it. You will then be taken to the hotkey editor
screen.
The last two buttons on this screen (lower right corner) are the okay
and cancel buttons. These allow you to say, ok lets use all these custom
button changes and go back to configopus main screen, or oops! forget
all this, and lets just leave.

3. 14 Hotkeys/editor:

Name:

This field is simply a nane for the hotkey and can contain anything.
Directory Opus only uses this as a label so that you will know what
the hotkey does.

Hotkey:

Is a display area for the hotkey sequence. It shows the defined hotkey
or is empty if one has not been defined.

Sample:

To modify the hotkey, select this button. While the sample button is
selected, any keys, along with any qualifiers you press will be inserted
in the hotkey field. To turn off sample mode, select the sample button
again.
To clear the hotkey sequence simply select the sample button with the
right mouse button.
The remaining part of this requester is described in the command
editor section.

3. 15 Menus/manager:

This section allows you to configure the menus. There are 100 custom
menu items, arranged as five menus of twenty items each. The menu
configuration screen displays the five menus, with the menu titles
at the top.
All the menu items in each menu strip are not displayed at once;
because space is limited on the screen, only a certain number are visable
at a time. To move through the menu items, use the slider at the right of
the screen.
There are ten buttons across the bottom of the screen. Some of these
buttons stay selected when selected with the left mouse button.
For instance, delete item will stay selected to remind you that you
are now in delete item mode. To leave this mode, select delete item
again.
The buttons below, that work in this fashion are:copy menu, swap menu,
delete menu, sort menu, insert item, copy item, swap item and delete item.

Copy menu:

Copies the contents of one menu to another. When you have selected this
option, select a menu item in the actual menu you wish to copy, and then
a menu item in the menu you want to copy the first menu to.

Swap menu:

Swaps the contents of two menus. It works in the same way as the copy
menu function, except that the contents of the second menu are exchanged
and not replaced.

Delete menu:

Removes all functions from one of the five menus. Select a menu item
in the appropriate menu; a requester will appear to verify the
operation. If you select okay, the contents of the menu will be deleted.

Sort menu:

Sorts the contents of each selected menu alphabetically by name.

Insert item:

Allows you to insert a new item between two existing items.
Select the item in front of which you want the new item to be
inserted.

Copy item:

Allows you to copy one menu item to another. When you have selected
this option, select the menu iten to copy, and then the menu item to
copy it to.

Swap item:

Allows you to swap two menu items. It works in the same way as the
copy item function, except that the second item is exchanged and
not replaced.

Delete item:

Deletes menu items. Select the menu item you wish to delete. All menu
items below it will be moved up to fill the empty space.

The default or open menu items in the configure menu allow you to import
menus from either the default configuration or a configuration file
from disk.
To edit a menu item, make sure you are not in copy menu, swap menu, delete
menu, sort menu, insert item, copy item, swap item or delete item mode. Then
simply select it, and you will be taken to the menu item editor screen.

The last two buttons on this screen (lower right corner) are the okay
and cancel buttons. These allow you to say ok lets use all these custom
button changes and go back to configopus main screen, or oops! forget
all this and lets just leave.

3. 16 Menus/editor:

At the top of the menu item edit screen is an example of what the current
menu item looks like. The palettes on either side of the example allow
you to select the foreground and background colours of the menu item.

Name:

This field alows you to modify the name that appears on the menu item,
and is limited to 63 characters.

Shortcut key:

Is a display area for the shortcut key sequence. The shortcut key gives
the keyboard equivalent of this menu item.

Sample:

To modify the shortcut key, select this button:any keys, along with any
qualifiers you press will be inserted in the shortcut key field. To
turn off sample mode, select the sample button again.
To clear the shortcut key sequence simply select the sample button
with the right mouse button.
The remaining part of this requester is described in the command
editor section.

3. 17 Operations:

The operation configuration screen gives you complete control over the
way each of the listed operations is performed. You can cover any
contingency by specifying precisely how you want each operation to
be carried out in any situation that might arise. When you select one
of the buttons to the left of the screen, requesters will appear, asking
you how to proceed.

Copy:

This button allows you to check the amount of space available for
copying files and directories, and to set the archive bits once the
copying is finished. You are able to choose which parts of the file
information need to be copied. You are also given options to consider
if the file being copied already exists in the destination.

Date format:

With this button you may choose between the Amiga systems default or
three other formats for displaying the date.

Delete:

Without the reminders that this button summons, you might lose some
very valuable information.

Error check:

You may choose either dos requesters or the more comprehensive
Directory Opus error requesters when you select this button.

General:

This button displays miscellaneous flags that are detailed in the
operations/general subsection.

Icons:

With this button you may decide whether to create a drawer icon,
whether each files icon undergoes every change that befalls its file,
and whether an icon is selected automatically with its file.

List format:

The screen summoned by this button gives you control of the format of
the lists in both screens.

Update:

This button ofrfers various features that are detailed in the
operations/update subsection.

3. 17. 1 Operations/copy:

When copying files and directories:

Check destinations free space before starting:

This causes Directory Opus to check that the destination directory
has enough free space in it before attempting to copy selected files
and/or directories. If Directory Opus does think that all selected entries
will fit in the destination directory, it will alert you with a requester,
and give you the option of abandoning the copy process. If any selected
directories do not have sizes displayed for them, Directory Opus will
ask you if you wish it to perform a byte count on these directories
before seeing whether or not they will fit.

Set archive bit of scource after finishing:

After Directory Opus copies a file, the original file will get its archive
bit set to true. This means that the file has been archived.

Also copy scources... :

These flags tell directory opus that when it copies a file, it must also
copy these parts of the file information aas well. You can have all, none,
or any combination of these selected.

Datestamp:

Protection bits:

Comment:

What to do when a file already exists:

These flags tell directory opus what to do if a file that is being
copied already exists in the destination. Only one of these may be
selected. You have four options:

Always replace files:

Replaces the original file regardless.

Never replace files:

Will never replace the original file.

Replace only older files:

Replaces the original file only if the file to be copied has a more
recent last modification date.

Ask before replacing:

Asks the user what to do if the file already exists.

3. 17. 2 Operations/date format:

Date format:

This tells Directory Opus how to format dates. The Amigas operating
srstem uses the first (dd-mmm-yy) by default, but you may choose
whichever one you prefer.

dd-mmm-yy (22-sept-92)

yy-mm-dd (92-09-22)

mm-dd-yy (09-22-92)

dd-mm-yy (22-09-92)

Misc flags:

Name substitutiuon (today, tomorrow, etc):

Causes words like today, tomorrow or tuesday to be substituted for a
date, if appropriate.

12 hour clock:

This allows you to choose whether the clock format used by Directory
Opus be displayed in 12 hour or 24 hour format.

3. 17. 3 Operations/delete:

Ask before:

Commencing delete:

Tells Directory Opus to check with you before actually starting to delete.
This is rather a useful everyday option because its always better to
be safe than sorry.

Deleting files:

Tells Directory Opus to ask for confirmation before deleteing every
file.

Deleting non-empty directories:

Tells Directory Opus to ask for confirmation before deleting directories
that have items in them.

Misc flags:

Ignore the delete protection bit:

When deleteing, this sets the delete protection bit on all files that
do not have it set. This means that the files protected against deletion
will be deleted anyway.

3. 17. 4 Operations/error check:

Enable:

Dos requesters:

Disables Amigados requesters that would appear on the Directory Opus
screen (disk is write protected etc. ). instead, you will only see an
error message appear in the Directory Opus status bar.

Opus error requesters:

Causes Directory Opus to open its own error requester when an error is
encountered. This requester contains more information than the standard
Amigados.

3. 17. 5 Operations/general:

Misc flags:

Click-m-click drag:

Drags files or directories. To drag a file you must (holding down the
left mouse button) move the mouse to the left or right of the file. Do
not move up or down until the selected file has been lifted as this
would initiate drag-selecting. You can also press the right mouse button
while holding down the left to initiate dragging. If you drop the file
in the other directory window it will be the same as click-m-clicking.
If you drop the file on a custom button at the bottom of the screen
that buttons action will be performed.

Display info:

Makes Directory Opus behave as it did in version 1, by displaying a
files protection bits, datestamp and commet in the status bar. Directory
opus now displays these in the directory windows, and keeps a count of
selected files, etc. in the status bar instead. If you prefer the old
style display, turn display info on. All file information will be displayed
in the status bar as you select entries, as well as in the directory
windows. With this turned on, you can use the byte command to view the
count of selected entries.

File double-click:

Directory Opus will interrogate a file that is double clicked on with
the left mouse button, and will perform the default action for that file
type.
You may your own filetypes, and specify what action is to be performed
on them. However, there are also several hard coded filetypes. These are
IFF ILBM pictures and brushes, icons, fonts, IFF 8SVX sounds, and executable
programs.
If a file does not match any of the user defined filetypes, it is checked
to see if it is one of the hard coded types. In that case, the default
action for these filetypes is performed. If a file does not match any
filetypes user-defined or otherwise, it is treated as a text file, and
loaded into the text viewer. If any ansi control sequences are detected,
these will be displayed correctly. If the file contains any non-text
characters, it will be read in hexadecimal format.

Window slider activate:

Causes a directory window to become active whenever its sliders or
arrow buttons are selected. If this option is not enabled, selecting
the sliders or arrow buttons of a directory will not cause it to become
active.

3. 17. 6 Operations/icons:

Misc flags:

Create icons with directories:

Creates a drawer icon whenever you create a directory with the makedir
command.

Perform all actions on icons as well:

Whatever happens to a file will happen to that files icon as well.
For instance, if you delete the file data, data.info (if it exists) will
be deleted too. If you rename the file frog to buffalo, the frog.info
(if it exists) will be renamed as buffalo. Info automatically.

Select icons automatically:

Has similar results to perform all actions on icons as well, except
that whenever you select a file, its associated .info file (if it exists)
is also selected.

3. 17. 7 Operations/list format:

Format of the list in the:

Left window:

Right window:

The cycle button specifies which directory window you are modifying.
This allows you to have different list formats in each window, but it
does require you to specify the format for each window. If you change
the format (using the buttons described below), and you want it to be
the same for both windows, dont forget to click on this button and
make the corresponding changes to the other window.

Available display items:

This list allows you to add display items to the selected display items
list by clicking on them. An item can only be added once, so if you click
on an item that is already in the list, nothing will happen. The available
display items are:

File name:

File size:

Protection bits:

Creation date:

File comment:

File type:

Displayed lengths:

The fields allow you to adjust the width of some these items. The adjustable
lengths are:

File name:

File comment:

File type:

Selected display items:

When you select an item from the list of available display items. It appears
here. This allows you to specify exactly what to display. When you select an
item in this list, it places a check mark next to it. This indicates
which item to sort the window list on. Clicking on the checked item
unchecks it. If no items are checked then the directory window will
not be sorted.

Reset:

This button causes the list to reset to the factory default settings.

Clear:

The left mouse button clears all entries, allowing you to start all
over again.

The right mouse button clears the last entry in the list, allowing
you to correct a mistake.

Entry separation:

This cycle button allows you to specify how directories and files
are sorted.

Directories first:

Files first:

Mix files/directories:

Reverse sorting:

This specifies that the list should sort in reverse order. For instance
instead of a coming before b, b would come before a.

3. 17. 8 Operations/update:

When processing files:

Makes Directory Opus open a progress indicator window when it is processing
files.

Left justify filename in status bar:

Left justifies filenames in the status bar rather than centering them
as usual.

Scroll directory window to follow operation:

Causes the directory windows to scroll, ensuring the visibility of the
current entry being acted upon in an operation. The display is returned
to its original position when the operation is complete.

Update free disk space:

Causes the free space display in the disk name display at the top
of the active directory window to be updated whenever a file is
copied or deleted from the directory. Otherwise, the display is only
updated at the end of a complete operation.

Misc flags:

Directory refresh using startnotify 2. 0 os only:

Sets up automatic notification of the currently visable directories.
If the directories are modified outside Directory Opus (i. e. , by another
program), Directory Opus will automatically re-read the directory to
reflect the changes.

Warning while this feature works in many circumstances, the current
versions of 2.xx and 3.xx of the operating system have a bug preventing
this from being completely useful. Currently the operating system does
not notify us to all events, but we have left this option in place so
when the bug is fixed Directory Opus will be ready.

Redraw more than a quarter of a page:

Causes Directory Opus to redraw the window if you move more than a
quarter of a page in either direction. This flag can greatly speed
up movement through directories. Ordinarily, if you use the sliders
to move a directory less than a complete page in either direction,
the directory window will scroll one file at a time. It is only if
you move a complete page or more at once that the window will
actually be redrawnn. Although not as pleasing aesthetically,
redrawing is considerably faster, especially in high resolution
modes.

3. 18 Screen:

The screen configuration screen allows you to modify the appearance
of the screen to suit your needs and preferences. Requesters concerning
the screens features will appear when you click on one of the buttons
at the left side of the screen.

Arrows:

Allows you to specify where the arrows on the sliders used by Directory
Opus will appear.

Colours:

Allows you modify the pen colours of almost all the components of
the Directory Opus screen.

Fonts:

Allows you to specify the fonts used in different parts of Directory
Opus.

General:

Allows you to specify various options for the screens appearance.

Palette:

Allows you to set the colours of the Directory Opus screen.

Screen mode:

Allows you to specify the mode, size and depth of the Directory
Opus screen.

Okay and cancel:

These allow oyu to say either ok, lets use the screen settings
and go back to directory opus, or oops! forget all that, and
lets get out of here!.

3. 18. 1 Screen/arrows:

This screen allows you to specify where the arrows on the sliders used
by Directory Opus will appear. There are three choices for each of the
three slider types. You can also adjust the size of the arrows.
The easiest way to learn how to use this is just to play with it. Select
the slider type by clicking on it, or cycle through the types by clicking
on the cycle button. The selected slider type will be highlighted.

Adjust size:

These buttons allow you to adjust the width of the arrows in the
selected slider type. You can certainly make these huge if you want.

3. 18. 2 Screen/colours:

This requester allows you to modify the pen colours of almost all the
components of the Directory Opus screen. The number of colours to choose
from are specified in the screen/screen mode: and the colour palette
is specified in screen/palette.

A mock up of the Directory Opus screen is shown, to allow you to see
the results of your colour changes. To select the item you want to
modify, either click on it in the example box, or click the cycle button
at the top of the screen to advance to the next item.
To modify the colours of an item, use the foreground and background
palette boxes. Note that OS 1.3, you cannot modify the colour of some
items.

3. 18. 3 Screen/fonts:

The screen/fonts requester allows you to specify the fonts used in
different parts of Directory Opus. when this option is selected for
the very first time, there will be a delay while Directory Opus looks
to see which fonts exist in the system.

Display item:

The items for which you may configure a font are displayed in this
list. Clicking on an item displays the currently selected font and
size in the font and size lists. You can then use these lists to
select the desired values for the display item.

Font:

This list contains the list of available fonts. The selected font
for the display item is highlighted. Click on a font name to change
the selected font.

Size:

This list contains the sizes available for the currently selected
font. The selected size is highlighted. Click on a font size to change
the selected size.

An example of the currently selected font and size will be displayed
below these lists.

Some display items accept non-proportional fonts, and others only
accept 8-point fonts. The list of available fonts will change to filter
out unaccepttabel fonts.

Note that under os 1.3 you cannot use a different font in the pathname
field. Setting the pathname to a larger font will make the pathname field
larger, but under os 1.3 the string fields will still use the general
8 point font.

3. 18. 4 Screen/general:

This requester allows you to specify various options for the screens
appearance.

Visible screen title buttons:

Makes the close and depth buttons of the title bar visible on Directory
Opus sceen.

Bottom right tiny buttons:

Makes the tiny buttons in the lower right of Directory Opus screen
visible.

Button bank sliders:

Makes sliders appear beside the drive and custom button banks.
These make it easier to scroll through the banks.

Indicate button has rmb function:

All buttons with right mouse button function will have a dog-eared
upper right corner.

New look sliders:

The sliders adopt the new style of operating system 2.0.

Draggable requesters:

All requesters will have a window title bar allowing you to move
it.

3. 18. 5 Screen/palette:

The screen/palette requester allows you to set the colours of the
Directory Opus screen. a palette box is displayed, allowing you to
select the colour to modify. You can change the colour by using the
sliders to adjust the red, green and blue components. You can also
enter colour values directly, using the string fields.

Presets:

There are also several preset colour palettes available, which you
can select just by clicking. The reset entry will return the colours
to the values they had when you entered this section (an undo feature
basically). The Directory Opus default entry sets the default Directory
Opus palette. the Workbench default entry has the default Workbench
colours. The Workbench current entry is the colours currently set
on the Workbench screen. The other presets are diffeerent settings which
you can experiment with at your own leisure.

3. 18. 6 Screen/screen mode:

The screen/screen mode requester allows you to specify the mode, size
and depth of the Directory Opus screen.

Display mode:

Contains a list of the available display modes. Under OS 1.3 this will
contain high res, high res laced, Workbench:use and Workbench:clone.
under os 2.0 the modes available will vary depending upon the monitors
currently active in your system.
The characteristics of the selected display mode are shown at the
bottom of the screen.
There are two special items on the list.

Workbench use:

Causes Directory Opus to open a window on the Workbench screen, and not
to open a custom screen. The width and height of this window are editable,
but the number of colours is fixed at the current Workbench depth.

Workbench clone:

Causes Directory Opus to open a screen in the same mode and exactly
the same size as the Workbench screen. The size of this screen is
not editable, but you may modify the number of colours.

Width:

This field allows you to specify the screen width.

Use default:

When this button contains a check, the width field can not be changed.
It will not be changed. It will, however, display the default value to
be used. When you click on this button, it will allow you to change
the value in the width field.

(When you are using workbench clone, the use default button cannot
be deselected. )

Height:

This field allows you to specify the screen height.

Use default:

When this button contains a check, the height field can not be changed.
It will, however, display the default value to be used. When you click
on this button, it will allow you to change the value in the height
field.

(When you are using workbench clone, the use default button cannot
be deselected. )

Colours:

Depending upon the selected screen mode, the number of colours will
vary from four to sixteen. There are screen modes with a maximum of
less than sixteen; if this is the case, your selection will be limited.

Half-height screen:

This causes the directory opus screen to open at half its normal
height, and to positioned halfway down the display. With an interlaced
screen, this would give you a screen the size of a normal (non-interlaced)
screen, with the screen behind it still bartially visible. Turning on
the half-height screen option will not modify the systems screen height
setting.

3. 19 System:

The system configuration screen lets you tell Directory Opus how to
run several operations.

Amigados:

Allows you to specify how directory opus starts up amigados
programs.

Clocks:

Allows you to specify how directory opus displays clock
information.

Directories:

Allows you to set various options for directory operations.

Hotkey:

Allows you to specify the hotkey to activate Directory Opus.

Icons:

Allows you to specify the icons which will be created with the
iiicaddicon command.

Modules:

Allows you to specify preloaded external modules.

Show pattern:

Allows you to specify files to be shown or excluded from the
directory lists.

Startup:

Allows you to specify various startup options.

View and play:

Allows you to configure options for directory opus viewers.

Okay and cancel:

These allow you to say either ok, lets use the screen settings
and go back to directory opus, or oops! forget all that, and lets
get out of here!.

3. 19. 1 System/amigados:

This requester allows you to specify how Directory Opus starts up
amigados programs.

Running Amigados applications:

Shell:

This field is the amigados command used to launch programs that have
output windows. It defaults to newcli. If you wish to use a shell, you
could change the default to newshell. If you wish to use a wshell, you
could change it to newwsh. The magnifying glass button to the left of
this field opens a requester to help you locate the command you wish
to use.

Console:

This is the console under which all output windows are opened. It is
also used to open a cli by the newcli command, and by the run command
when no files are selected. The console allows you to specify the
size, position and title of the output window. It follows the standard
Amigados format, namely:

Device:leftedge/topedge/width/height/title/options.

Device

This is the device you are using. It is normally con, but under Amigados
1.3 it may be newcon (which will open a shell instead of a cli).

Leftedge:

The left edge of the window ( x coordinate, in pixels).

Topedge:

The top edge of the window ( y coordinate, in pixels).

Width:

The width of the window in pixels.

Height:

The height of the window in pixels.

Title:

The title of the window.

Options:

Some devices allow you to specify optional parameters (i. e. , /close).
The valid parameters vary, so consult the devices documentation for
details.

An example is:

Con:20/10/600/180/directory opus output/close.

Start-up script:

This is an Amigados batch script that will be performed before Directory
Opus launches any programs.

Priority:

Main priority allows you to specify the priority at which Directory
Opus itself runs. the default priority is 0, which means that it
peacefully coexists with everything else. Setting the priority
higher means that while Directory Opus will not be slowed down much
by other tasks, the performance of other tasks will suffer. It is
suggested that you set the priority no higher than 10.

3. 19. 2 System/clocks:

This requester allows you to specify how Directory Opus displays
clock information.

Clock/memory bar:

These flags tell Directory Opus how to format the clock bar at the
bottom of its screen. You can include any combination of these items,
but in some fonts you may not be able to see all the items selected
because their space may be limited.

Memory monitor:

Displays the amount of chip memory, fast memory and the total memory
in the clock bar.

Cpu monitor:

Displays the percentage of cpu time that is being used. 100% indicates
that there is not any idle time and that at least one process is
attempting to run continuously.

Date:

Displays the current date in the clock bar.

Time:

Displays the current time in the clock bar.

Show free space as:

There are two groups of buttons with this title. One applies to the
clock/memory bar, and the other applies to the iconified window.
They allow you to specify how the memory monitor, when enabled, will
display memory.

Bytes free:

Displays all digits (this can be hard to read with large values).

Kilo/megabytes free:

Displays value in either kilobytes or megabytes as applicable.

Text format:

There are two groups of buttons with this title. one applicable
to the clock/memory bar, and the other applies to the iconified
window. They allow you to specify how the titles for the memory
monitor, when enabled, will be displayed.

The choices are:-

Chip and fast:

C and f:

When iconified:

These buttons allow you to specify how Directory Opus should
act when iconified.

Window:

The following flags allow you to specify what is displayed
in the window.

Memory monitor:

Date:

Cpu monitor:

Time:

Directory Opus will iconify to a small window on Workbench. If this
window is enabled, its last position is saved when you save the
configuration file.

To un-iconify the window, simply activate it by clicking on it with
the leftmuse button and then press the right mouse button.

No window:

Directory Opus will close all windows.

An appicon:

directory opus will open an icon on workbench. Simply double click
on the icon to uniconify it.

3. 19. 3 System/directories:

This requester allows you to set various options for directory
operations.

Directory caches:

Buffers per window:

Allows you to specify the number of buffers to be allocated to
each directory window. You can have any value from one to 255.

Always move to empty buffer:

Causes Directory Opus to use an empty buffer (if possible)
whenever a new directory is read. A new directory is read whenever
you enter a path in the directory fields, double click or click
m click on a directory name, or select a drive button.

Re-read changed or incomplete buffers:

When a buffered directory is shown, this will make Directory Opus check
the directory on disk to see if it has changed. If it has, this will
cause a re-read of the directory. Also, if the original reading of a
directory was interrupted it will be re-read in.

Search buffers on:

Parent/root operation:

This option causes the directory buffers to be searched for the parent
or root directory of the current directory, whenever the parent or root
commands are chosen. If the parent or root directory exists in a buffer
(i. e. , it has already been read), the buffered directory is retrieved
from memory. This can save a lot of needless disk access.

Double click/click-m-click directory read:

When a directory is selected via double click or click-m-click this
will cause Directory Opus to search the buffered directories first.

Misc flags:

Auto diskchange:

Causes Directory Opus to sence disk changes in any drive. If you have
the root directory open in either of the directory windows when you
change the disk, then the new disk will be read automatically. This
allows you to scan through different disks without having to follow
the usual selection procedure.

Auto disk load:

This option works in a similar fashion to auto diskchange, except that
it detects any disk being inserted, not just those disks currently
being displayed. If you insert a disk in a floppy drive with this
option turned on, you will be asked whether you wish to read the disk
into the left or the right window.

Expand pathnames:

This flag will cause all paths to be expanded to their full pathnames.
For example, if this flag was enabled and you entered s: in the directory
field, the name might be expanded to workbench1.3:s/. It will also do this
when when you select a drive button. for instance if you selected a drive
button marked df0:, the actual name of the disk would be inserted in the
directory field.
You should note that ass the expand pathnames flag causes the actual
volume name of disks to be used, the system (and you) may get confused
when using two two disks with the same name. As a rule, you should avoid
using identically named disks at the same time.

Use exall():os2.0 only:

If selected, Directory Opus will use the exall function to read
directories, rather than the old examine ()/exnext() combination.
exall() can be slightly faster than the old method.

Warning:

Operating systems 2.x nd 3.x currently have a bug that causes
them to skip directory entries when using exall() on certain
devices. Some devices to watch out for include: cd rom, parnet
and networks. If you have problems, simply turn off this option.

Show free space as:

These allow you to choose how to measure the free space that is
displayed alongside the disk name.

Bytes free:

Display the number of free bytes.

Kilo/megabytes free:

Displays the amount of free space in either kilobytes or megabytes
(depending upon the size.

Blocks free:

Displays the number of blocks free (as will also be shown by the
Amigados info command).

Percentage of space free:

Displays the free space as a percentage of the total size.

3. 19. 4 System/hotkey:

This requester allows you to specify the Directory Opus activate
hotkey.

Uniconify/activate hotkey:

This hotkey is really a combination of keys that you press to do
one of four things:

If directory opus is iconified, it will be uniconified.

If the Directory Opus is open, but at the back of the display, it
will be brought to the front.

If the system has been pulled down using the screen drag bar, it
will be brought to the top.

If the screen is already at the front of the display, it will be
moved to the back.

Sample:

To modify the hotkey, select the sample button at the right of
the hotkey field. While the sample button is selected, any keys
that you press, along with any qualifiers, will be inserted in
the hotkey field. To turn off sample mode, select the sample
button again.
To remove the hotkey simply select the sample button with the
right mouse button.
The default hotkeys are control+lshift+lalt, meaning that pressing
the control key, the left shift key and the left alt keys together
will perform the action.

Use middle mouse button:

With this flag turned on Directory Opus will also use the middle
mouse button as well as the hotkey defined above.

3. 19. 5 System/icons:

This requester allows you to specify the icons which will be created
with the addicon command.

Addicons icons:

This list includes three built in icon types: drawer, tool and project.
in addition, each of the filetypes is included in this list. This
system allows you to specify your own icons to use with the addicon
command if you do not like the default icons. Simply select the type
of iconyou want to change (e. g. , drawer, tool, etc. ), and its current
icon will appear in the lower right corner. You may change the icon
by modifying the field directly below the list. The magnifying glass
button is provided to allow you to find the icon you want easily.

Under OS 1.3 we provide some built in icon images but under OS 2.0
we use the system standard images.

Projects default tool:

Allows you to modify the default tool of project icons added with
the addicon command. This only works with the built in project icon
or the default workbench project icon; not with user supplied icons.
For example, you may set the default tool to c:fullview. then, whenever
you double click from Workbench on an icon that you have added to
a project, fullview will be invoked.

3. 19. 6 System/modules:

An external module is a small program which Directory Opus runs to
perform infrequent operations. By making them external, they do not
have to be in memory at all times. If you are not concerned with
their memory usage and you dont want Directory Opus to load them
each time you use them, this requester allows you to specify which
modules you want to be preloaded.

External support modules:

Lists all external modules supported by directory opus. If you want
a module to be preloaded, select it and a checkmark will appar. Select
it again if you do not want it preloaded. Preloaded modules take less
time to start up but use additional ram.

Language:

Allows you to select a language for Directory Opus. by default, directory
opus uses the built in english language, but as other languages become
available they will appear here. To select one for use, simply click
on it.

3. 19. 7 System/show pattern:

This requester allows you to specify files to show or exclude from the
directory lists.

Directory list pattern:

Hide files with hidden bit set:

Tells Directory Opus to take notice of the h bit; any files that have
this protection bit set will not be displayed.

Show:

Allows a wildcard pattern against which all files are checked.
if the file matches this pattern, it is displayed.

Hide:

Allows a wildcard pattern against which all files are checked.
If the file matches this pattern, it is not displayed.

3. 19. 8 System/startup:

This requester allows you to specify various startup options.

Directories to be read on startup:

These fields allow you to specify the path name of a directory
that is loaded automatically into the left or right window
whenever directory opus starts. The magnifying glass button to
the left of these fields opens a directory requester to help
you locate the path you require.

Left:

This field specifies the startup directory for the left window.

Right:

This field specifies the startup directory for the right window.

Arexx scripts to execute on:

These allow you to specify the name of two arexx scripts that are
automatically run when directory opus starts (startup), or when it
returns from an iconified state (uniconify).

Startup:

This arexx script is executed when Directory Opus first starts
up.

Uniconify:

The uniconify arexx script is executed when Directory Opus is
uniconified.

CFG return:

This arexx script is executed when directory opus returns from
the configopus utility.

3. 19. 9 System/view and play:

This requester allows you to configure options for Directory
Opus viewers.

Picture/animation viewer (IFF ILBM/anim):

Balck background between pictures:

This flag causes a blank screen to be displayed while each
picture is loading. Otherwise, the Directory Opus screen will
be displayed in between each picture.

Start animation paused:

Makes animation come up paused. This is particulary useful
when an animation is simply a collection of pictures and
not really an animation.

8 bits per gun colour:

This tells Directory Opus to treat the colour information
in IFF ILBMs as having 8 bits per gun. Pictures that have
4 bits per gun, per aga, are shown a little dimmer than usual.

Show delay:

Allows you to show pictures as a simple slideshow. If set to 0,
pictures will wait for you to press the left mouse button before
continuing. On other settings, the pictures will continue to display
one after the other for the specified time in seconds.

Fade delay:

Allows you to configure the speed at which pictures fade in and out.
If it is set to 0, there will be no fading at all. The default is 2;
the maximum is 10. The value, by the way, indicates in 60ths (50ths on
pal) of a second the time between each change in colour.

Sound player (IFF 8SVX):

Turn audio filter of for play:

Causes the high pass audio filter to be turned off while each IFF
8SVX sound file is played. Note that on a1000s the audio filter may
not be software selectable.

Loop on double click:

Tells Directory Opus to behave as it did in version 3. 4. In that
version, when you double clicked on sounds, they played in a looped
fashion. Under version 4.0 the sound is played only once.

Text viewer:

Text viewer borders:

Tell the text viewer to have a silder and fancier borders. Note
that with the fancier borders and sliders you may not be able
to read text files that are 80 characters unless you use a smaller
font or wider screen.

Tab size:

Allows you to specify the number of spaces to which a tab character
is equivalent in the ansiread command. The default is 8, which is also
the ansi standard.



                               Chapter 4


Commands:

This chapter lists the Directory Opus commands in alphbetical order.
Lets begin with an example of an entrys layout, with its component
parts explained as they occur.

Command ARexx only:

The name of the command comes first. If it is followed by the words
arexx only it means that it is a command that can only be called
from another program by using the ARexx intercommunication language.
Otherwise, a command can be used both in a button (menu, hotkey or filetype)
and as an arexx command.

Command this is the syntax of the command. Elements in square brackets
are optional.

Below the syntax, its elements are explained in turn.
If necessary, there will follow notes pertaining to the use of the
particular command.

All Directory Opus commands when called from ARexx respond with two
variables: rc (the error status code) and result. RC will always be
an integer value indicating the severity of an error, 0 being no
error. Result will indicate success or failure of the command,
usually expressed as an integer value, or it may be data, such as the
name of a file.

Abort print:

Abort the current print process.

ARexx results:

RC= 0
Result = nothing was printing.
1 Somthing was printing but is now aborted.

About:

This command displays copyright information and mailing addresses.

ARexx results:

RC=0
Result = undefined

Add cust entry:
ARexx only:

Addcustentry text [userdata] [fgpen] [bgpen] [selectable] [show] [before]

Text is the text for the entry, and may be up to 256 characters long.
The dimensions of the horizontal slider are adjusted automatically
to the longest entry.

Userdata optional; user data for this entry. This is not displayed but
can be retrieved, defaults to nothing.

Fgpen:

Optional; pen colour to display entry in or -1 for default file
colour, defaults to -1.

Bgpen:

Optional; backgroung colour of entry or -1 for default file background
colour, defaults to -1.

Selectable:

Optional; indicates if entry is selectable (0= not selectable or 1=
selectable), defaults to 1.

Show:

Optional; boolean to update directory display (0=do not update,
1=update), defaults to 0.

Before:

Optional; ordinal entry number before which to add this entry. a 0 adds
the entry to the begining of the list -1 adds at the end of the list,
defaults to -1.

This is similar to the addfile command, but allows for entries of up
to 256 characters. Entries added with this command are completely user
defined. This command will fail if there are any normal entries already
in the active window, so you should always call clearwin before using
it. by default, entries are not sorted in any way; the most recent entry
will be shown as the last.

ARexx results:

RC=0
Result =0 or 1 to indicate failure or success.

Addcusthandler;

Addcusthandler portname [win]

Portname name of handlers message port.

Win:

Optional; window to add a custom handler to (-1= current window, 0=left
or 1=right) defaults to -1.

This command will attach an ARexx portname to the current directory
buffer. When you manipulate the buffers entries, Directory Opus will
pass messages to the special portname. This command is only used with
buffers created using addcustentry. Currently the only two actions
supported are double click and click-m-click. As an example, this system
could be used to create a phonebook system or a network manager with
Directory Opus.

ARexx results;

RC=0
Result= name of old handlers message port (if there was one)

Addfile:

Addfile name, size, type, seconds, comment, protection, reserved. show.

Name:

Name of entry.

Size:

Size in bytes of entry.

Type:

Type of entry (-1= file or 1= dir).

Seconds;

Datestamp of file, seconds from jan 1, 1978 (date that AmigaDos
considers the begining of time)

Comment:

File comment.

Protection:

Protection bits in ascii form rw would mean readable and writable.

Reserved:

Reserved, must be 0 for now

Show:

Update directory display boolean

This command adds a file or directory entry to the active directory
window.

ARexx results;

RC=0
Result = 0 or 1 to indicate failure or success.

Addicon:

Addicon [name]

Name optional; name of file.

This will add icons to all selected files and directories in the active
directory window. Directory Opus automatically senses what sort of file
it is (drawer, project, tool, etc) and will arr the appropriate icon. Under
os 2.0, however, we use the workbench default icons. you may specify your
own icons in the configopus if the default icons are not suitable. You
may also specify the default tool to be used for project icons.
If the name is not given, it will use the first available selected item
in the current directory window.

ARexx results:

RC=0

Result = undefined.

Alarm:

Alarm, this command will sound an alarm on both or either sound
channels. You could use this command to warn people that they have selected
a dangerous command. For instance, you could modify the delete button
to read:

Command alarm
Command delete

ARexx results:

RC=0

Result= undifined.

All:

This command selects all files and directories in the active directory
window.

ARexx results:

RC=0

Result = undefined.

ANSIRead:

ANSIRead [name]

Name optional; name of file.

This command operates in exactly the same way as the read command, except
that it displays ansi control sequences (colours and typestyles) properly,
and also handles tab characters correctly. If the name is not given it
will use the first available selected item in the current directory
window.

ARexx results:

RC=0
Result=undefined.

ARexx:

Arexx [command]

Command optional; command to execute.

This allows you to launch an arexx script or execute any Directory
Opus ARexx command from within Directory Opus. If the command is not
given a requester will open asking the user for one.

ARexx results:

RC=0

Result = undefined.

Assign:

Assign [name]

Name optional; name to assign.

This command allows you to assign a logical device name to the currently
active directory. The c: device is an example of a logical device; it is
not a physical disk itself, but is a directory that has been assigned
the name c:. For example, a simpe name such as text: can be assigned to
a long and complicated pathname such as;
Dh0:projects/work/1989/april/bits&pieces/text
from then on, whenever you enter text: into a directory button, you will
go straight to the directory at the end of the assigned path, instead
of having to go through all the sub-directories on the way. You can use
the assignment in any other program as well. Logical devices always
end with a colon.
Assign also allows you to cancel a previously assigned device, or reassign
a device to another directory. To do this, press the right mouse button
over the s (select) button to activate the getdevices command. Select
the assigned device(s) you wish to change, and invoke the assign command.
A requester will apear, into which you can type the new pathname to be
assigned each device name. If you enter a blank string, that logical
device will be unassigned.

ARexx results:

RC=0

Result = undefined.

Beep:

This command will sounda beep on both or either of the sound channels.
You could use this command to signify that a command has finished.
For instance, you could modify the directory option to read:

Command diskcopy
Command beep

In versions of the operating system later than 38 (2.1) this command
will call the system beep routine. Under earlier versions it will sound
its own beep.

ARexx results:

RC=0

Result=undefined.

Buffer list:

Buffer list [win]

Win optional; window to scan the buffer list into (-1=current window,
0=left or 1=right) defaults to -1.
This command displays a list of all the buffered directories. You may
then double click on one of the displayed buffers to jump to that buffer
immediately, rather than clicking on the arrows to cycle through the
buffers one by one.

Arexx results:

RC=0
Result=undefined

Busy:

Busy [on/off]

On/off optional; adjust the busy pointer, defaults to on.

This command turns on or off the busy pointer.

ARexx result:

RC=0
Result=undefined.

Buttoniconify:

Buttoniconify [rows] [bank]

Rows optional; number of button rows. this can be 1, 2, 3 or 6.
defaults to whatever Directory Opus to.

Bank optional; bank number to display initially, defaults to 1.

This causes Directory Opus to open a window on workbench containing
the custom buttons.

ARexx results:

RC=0
Result=undefined.

CD:

CD [path]

Path optional; new current directory path, if path is not given a requester
will open.

This command allows you to set the current working directory for Directory
Opus. This is the directory that is read if you press return on an empty
directory button.

ARexx results:

RC=0
Result=undefined.

Check abort:

This command allows you to monitor, from an arexx script, whether the
user has pressed the left and right mouse buttons together (to abort).
It also resets the abort flag every time it is called. If you plan to
use the checkabort command. You should call checkabort at the start of
the script (to reset the abort flag), before actually using it to
check the abort status.

ARexx results:

RC=0
Result=0 if abort sequence has not been hit, 1 if it has

Checkfit:

Checkfit [win]

Win optional; window to a checkfit on
(-1=current window, 0=left or 1=right) defaults to -1.

This works in the same way as getsizes does except that its calculation
is based on disk block sizes, and is therefore much more accurate.
The disadvantage to checkfit is that it needs to recalculate every time
the destinations block size changes. Therefore, even if all scource
directories already have their sizes shown, checkfit may need to scan
them all again. Operations like copy, etc, that generate directory sizes,
are not suitable for checkfit, and so again checkfit will need to scan
all selected directories. Checkfit displays the total number of bytes
needed and the number of bytes free (i. e. , block numbers multiplied by
the block size), and the percentage of files that will actually fit. If
they will all fit, it shows 100%, if only half fit, it shows 50%.
The getsizes command is retained as it can be used quickly to provide
a rough guide. Checkfit can completely replace the getsizes command if
you dont mind it having to rescan directories when you might not have
expected it.

ARexx results:

RC=0
Result=undefined

Clearbuffers:

This command will clear the contents of all the directory buffers other
than the two that are currently displayed. All unused memory will be
de-allocated. This is a good way to free memory quickly if you have lots
of used buffers and are running a bit low on memory.

Arexx results:

RC=0
Result=undefined

Clearsizes:

Clearsizes [win]

Win optional; window to clear the sizes from (-1=current window, 0 = left
or 1 = right)
defaults to -1.

If a directorys size is already displayed, then the directory will not
be re-scanned when selected nor the getsizes command invoked. This could
mean that the directory size is inaccurate, especially if any files have
been created or deleted in it by another program. selecting one or more
directories, and then selecting the clearsizes command, will cause the
directory sizes to disappear. You can then reselect the directories,
invoke the getsizes command, and the directories will be re-scanned and
their updated sizes displayed.

ARexx results:

RC=0
Result=undefined

Clearwin:

Clearwin [win]

Win optional; window to clear
(-1=current window, 0= left or 1 right)
defaults to -1.

This command will clear the contents of a directory window.

ARexx results:

RC=0
Result=undefined

Clone:

Clone [name] [new name]

New name optional; new file name

This command allows you to make a copy of selected entries in the same
directory, and rename them. A requester will appear for each entry, asking
for the new name. This can also work with a specified file. If a new name
is not given then a requester will appear.

ARexx results:

RC=0
Result=undefined

Comment:

Comment [name] [comment]

Name optional; file name

Comment optional; comment string

This command allows you to change the comment, or filenote, of the selected
files and directories in the active directory window. When directories
are selected, you are asked whether the files within them are to have
their comments modified also. For each entry, you are presented with a
requester containing its current comment. To change the comment, edit
it and press return. To retain the comment just press return.
To set the comment of all selected entries you should the all button
from the comment requester; choosing okay or pressing return will set
the comments one file at a time.

ARexx results:

RC=0
Result=undefined

Configure:

Simply starts up the configuration program.

ARexx results:

RC=0
Result=undefined

Contst:

If there is a song paused, then it starts it playing again.

ARexx results:

RC=0
Result=undefined

Copy:

Copy [name] [destination]

Name optional; filename

Destination optional; destination directory

This command copies all selected files and directories in the active
directory window to the inactive directory window, keeping the same
names. If a filename is given then only that file will be copied, but
you may also specify a destination directory.

ARexx results:

RC=0
Result=undefined

Copyas:

Copyas [name] [new name]

Name optional; file name

New name optional; new file name

This command copies all selected files and directories in the active
directory window to the inactive directory window, and allows you to
specify a new name for each file or directory. If a filename is given,
then only that file will be copied.

ARexx results:

RC=0
Result=undefined

Copywindow:

Win optional; window to copy from
(-1=current window, 0=left or 1=right)
defaults to -1

This will copy the contents of a specified window or the current window
into the other window.

ARexx results:

RC=0
Result=undefined

Datestamp:

Datestamp [name] [date]

Name optional; file name

Date optional; date to set

This command allows you to change the datestamp of selected files and
directories in the active directory window. When directories are selected,
you are asked whether you also wish the files within them to have their
datestamps modified.
For each entry, you are presented with a requester. If you wish the file
to have its datestamp set to the current date and time, simply press return.
Otherwise, enter the desired date and time.
To set the datestamp of all selected entries you should select the all
button from the datestamp requester; choosing okay will set the datestamps
a file at a time.

ARexx results:

RC=0
Result=undefined

Defaults:

This causes Directory Opus to reset to the hard-coded, default configuration.
if you have modified the configuration yourself, and have not yet saved
it, you are asked if you wish to save it first.

ARexx results:

RC=0
Result=undefined

Delete:

Delete [name]

Name optional; filename

This will delete all selected entries or just the specified file in
the active directory window. Be careful with this, as it is easy to wipe
out valuable data.

ARexx results:

RC=0
Result=undefined

Dirtree:

Dirtree [win]
Win optional; window to create a directory tree in
(-1=current window, 0=left or 1=right)
defaults to -1.

This command will map out a directory tree in the active directory
window, or a specified window.

ARexx results:

RC=0
Result=undefined

Diskcopy:

Diskcopy [scource] destination [verify] [bump]

Source optional; source disk

Destinations destination disk

Verify optional; diskcopy with verify on

Bump optional; bump the revision of the disk name, as with workbench.

This command will diskcopy from scource to destination, with verify turned
on if the verify keyword is specified. If no scource or destination are
specified, the diskcopy requester is opened. If the bump keyword is given
then Directory Opus will bump the revision (copy_of_diskname)of the
disk name as workbench does.

ARexx results:

RC=0
Result=undefined

Diskcopybg:

Diskcopybg same as diskcopy

This command will execute diskcopy in the background mode. This allows
you to start up a diskcopy and still use Directory Opus.

ARexx results:

RC=0
Result=undefined

Diskinfo:

Diskinfo [path]

Path optional; path of a disk to get info about

This command displays some information about the disk the active
directory resides on, including space used and free, datestamp and
number of errors on the disk.

ARexx results:

RC=0
Result=undefined

Displaydir:

Displaydir [win]

Win optional; window to refresh
(-1=current window, 0=left or 1=right)
Defaults to -1.

This command will update the display for the active directory window
or the specified window.

ARexx results:

RC=0
Result=undefined

Dopustoback:

Move the directory opus to the back.

ARexx results:

RC=0
Result=undefined

Dopustofront:

Move the Directory Opus screen to the front.

ARexx results:

RC=0
Result=undefined

Encrypt:

Encrypt [name] [password]

Name optional; filename

Password optional; password to use

Have you ever had files that you wanted to encrypt so that only people
who know the password could understand them? This command allows you
to do just that. It will encrypt all selected files, using a password
that you enter, with a complex algorithm that most people will find
impossible to work out. The resulting files are not written over, but
are instead written to the destination directory. They will be the same
size as the original files, so you can ensure you have enough room in
the destination directory. To decrypt a previously encrypted file,
you should enter the same password preceded by a minus sign. For example,
to decrypt files you encrypted with the password foo, select the files,
choose the encrypt command and enter -foo as the password.

ARexx results:

RC=0
Result=undefined

Errorhelp:

Errorhelp [code]

Code optional; error code

This command gives you more information about dos error codes than is
generally available. When you select this option, you are asked for the
dos error code you want help with. Examples of dos error codes are
123, 205 and 225. You are then presented with a description of that error
and information pertaining to the possible cause and cure of the error.

ARexx results:

RC=0
Result=undefined

Execute:

Execute [filename]

Filename optional; name of a file to execute as a batch file

This command will attempt to execute each selected file in turn or to
execute a specific file as a batch file. This has the same effect as if
you had run the batch file via iconx, or via the execute command from
the Cli.

ARexx results:

RC=0
Result=undefined

Fileinfo:   ARexx only

Fileinfo name [separator] [win]

Name; name of file to give info for (must be in the active or specified
window)

Separator optional; character used to separate info

Win optional; window to get file from
(-1=current window, 0=left or 1=right)
Defaults to -1.

This command returns information on the entry called name (which must
be in the active directory window). The information returned is separated
by a separator(default separator is space), and consists of the filename,
the size in bytes, the size in blocks(not used yet), the file type (less
than 0 indicates a file, greater than 0 indicates a directory), the selected
status (boolean), the date (days), the date (seconds), the comment and
the protection bits.
The date is returned as a number of days since January 1st 1978, and as
the number of seconds since midnight. The protection bits are returned
in the format hsparwed (with a - character where the bit is not set).

ARexx results:

RC=0
Result=information about the file

Finishsection:

Internal only.

The finishsection command forces any preceding programs (AmigaDos,
Workbench, batch or ARexx) to executing before carrying on to the next
command. The next command need not be a Directory Opus command; it is
just more likely that it will be.
For instance, to add a beep to the end of the lharc list filetype command,
you would change the command list to read:

Aamigados lharc v {f}
Command  finishsection
Command  beep

ARexx results:

RC=0
Result=undefined

Format:

Format [drive] [verify] [quick] [noicons] [ffs] [inter] [cache]

Drive optional; drive to format

Verify optional; format with verify on

Quick optional; quick format

Noicons optional; format with no icons

FFS optional; format fast file system

Inter optional; format in international mode  os 2.0 only

Cache optional; format in directory caching mode  os 3.0 only

This allows you to format a new disk. All new disks need to be formatted
before the computer can write to them.
The verify flag allows you to turn verify on or off. If verify is turned
off, ghe format process will be much faster, but you will not be made aware
of any errors that qccur. If you dont completely trust your disks, leave
verify on. The FFS option in format allows you to format a disk to use
the fast filing system of kickstart 2.0. If you are running a kickstart
less than 2.0, you will still be able to select this option to format
a disk, however, reading FFS-formatted disks is impossible without 2.0
or greater.
International mode allows file and directory names to include accented
characters. Directory caching mode will decrease the capacity of your
disk but the directory reading speed will be much greater.

ARexx results:

RC=0
Result=undefined

Formatbg:

Formatbg same as format

This command will execute format in background mode. This allows you
to start up a format and still use Directory Opus.

ARexx results:

RC=0
Result=udefined

Getall:  ARexx only.

Getall [separator] [win]

Separator optional; character used to separate names

Win optional; window to get names from
(-1=current window, 0=left or 1=right)
defaults to -1.

This command returns, in the result variable, the names of all entries
in the active directory window. If separator is specified, the names
are separated by a separator. The default separator is a space. You
should be prepared to handle a long string.

ARexx results:

RC=0
Result=all the entries

Getdevices:

Getdevices [win]

Win optional; window to put device list into
(-1=current window, 0=left or 1=right)
Defaults to -1

This command displays a list of all devices, volumes and assigned
directories present in the system. You may then read in these devices
by double clicking on them. You can also select entire devices for
use with the hunt and search commands.

ARexx results:

RC=0
Result=undefined

Getdirs   ARexx only

Getdirs [separator] [win]

Separator optional; character used to separate directory names

Win optional; window to get directory names from
(-1=current window, 0=left or 1=right)
Defaults to -1.

This command returns, in the result variable, the names of directories
in the active directory window. If separator is specified, the names
are separated by the separator. The default separator is a space. you
should be prepared to handle a long string.

ARexx results:

RC=0
Result=all the directory entries

Getentry:  ARexx only

Getentry num

Num the entry number whose name is to be returned

Returns the file or directory name of entry number @num@.

ARexx results;

RC=0
Result=name of the specified entry

Getfiletype:  ARexx only

Getfiletype filename [type]

Filename file whose filetype is to be returned

Type optional; form of filetype id (0=file class description or
1=file class id), defaults to 0

Returns the filetype (if recognized) of the specified file.

ARexx results:

RC=0
Result=filetype id of the file if filetype is known

Getfiles:  ARexx only.

Getfiles [separator] [win]

Separator optional; character used to separate filenames

Win optional; window to get filenames from
(-1=current window, 0=left or 1=right)
defaults to -1.

This command returns, in the result variable, the names of all files
in the active directory window. If separator is specified, the names
are separated by a separator. The default separator is a space. You
should be prepared to handle a long string.

ARexx results:

RC=0
Result=all the file entries

Getnextselected:  ARexx only

Getnextselected [win]

Win optional; window to get next selected item from
(-1=current window, 0=left or 1=right)
defaults to -1

This command returns the name of the first selected entry (in the
result variable) in the active directory window. The entry is not
deselected afterwards so if you dont deselect it yourself, that is the
only name you will ever get returned.

ARexx results:

RC=0
Result=name of the entry

Getselectedall:   ARexx only

Getselectedall [separator] [win]

Separator optional; character used to separate names

Win optional; window to get names from
(-1=current window, 0=left or 1=right)
Defaults to -1.

This command returns, in the result variable, the names of all selected
entries in the active directory window. If separator is specified, the
names are separated by a separator. The default separator is a space.
You should be prepared to handle a long string.

ARexx results:

RC=0
Result=all the selected entries

Getselecteddirs:   ARexx only

Getselecteddirs [separator] [win]

Separator optional; character used to separate selected directory names

Win optional; window to get directory names from
(-1=current window, 0=left or 1=right)
defaults to -1.

This command returns, in the result variable, the names of all selected
directories in the active directory window. If separator is specified,
the names are separated by a separator. The default separator is a space.
You should be prepared to handle a long string.

ARexx results:

RC=0
Result=all the selected directory entries

Getselectedfiles:  ARexx only

Getselectedfiles [separator] [win]

Separator optional; character used to separate selected filenames

Win optional; window to get selected filenames from
(-1=current window, 0=left or 1=right)
defaults to -1.

This command returns, in the result variable, the names of all selected
files in the active directory window. If separator is specified, the names
are separated by a separator. The default separator is a space. You should
be prepared to hanle a long string.

ARexx results:

RC=0
Result=allthe selected file entries

Getsizes:

Getsizes [win]

Win optional; window to work with.
(-1=current window, 0=left or 1=right)
defaults to -1.

This will display in the status bar the same information that is displayed
when entries are selected (namely, the number of selected files, directories
and bytes, out of the total number of files, directories and bytes), along
with one additional piece of information. If the selected entries occupy
fewer bytes than the free space on the disk in the opposite directory
window, allowing all selected files to fit on the destination disk were
they to be copied, a y will be displayed after the count. Otherwise an n
will be displayed. If any directories are selected when getsizes is chosen,
the directories that do not already have a size displayed are scanned,
and the size of the directories are calculated and displayed.

ARexx results:

RC=0
Result=undefined

Getstring:  ARexx only

Getstring [message]

Message optional; text for requester

This command will open a requester for the user to enter text into. If
a message is given, that is used as a prompt for the requester.

ARexx results:

RC=0 success, 1 cancel was pressed
Result=string entered by user

Help:

Provided a help file has been loaded in, selecting any button or menu
after enabling help mode with this menu should result in the appearance
of some helpful text. To turn help mode off, select this command again.

ARexx results:

RC=0
Result=undefined

Hexread:

Hexread [name]

Name optional; name of file

This command will read the selected files in the same way as read, but
in hexadecimal format. This allows you view binary and other files containing
non-text characters.

ARexx results:

RC=0
Result=undefined

Hunt:

Hunt [name] [pattern]

Name optional; name of directory to hunt

Pattern optional; file pattern to hunt

This command allows you to search all selected directories (and their
sub-directories) for a specifies file or files. a requester appears asking
for the pattern to hunt for. You can use ful pattern matching for this
search. If a file matching the pattern is found, you are asked if you
wish to enter the directory containing it, or continue the search. If
you elect to enter the directory, the directory will be read and then
all matching entries will be highlighted.

ARexx results:

RC=0
Result=undefined

Iconify:

This command closes the directory opus window and screen, de-allocates
as much memory as possible, and then opens a small window on the Workbench
screen. This is known as iconifying, and allows you to have Directory Opus
constantly available while using the minimum amount of memory.
To determine the initial position of the iconified window, especially
if you start up Directory Opus in the iconified state, you should iconify
Directory Opus, and position the window as you would like it to appear.
Then re-enter Directory Opus, and save the configuration (described later).
To re-enter Directory Opus, simpe click the left mouse button in the
iconified window, the press the right mouse button. If you wish to quit
Directory Opus without going back into it, just click the close button
at the far left of the iconified window.
If you have the configuration option iconify type (described later)
set to hidden, the only way to re-enter Directory Opus is with the hotkeys.
These default to ctrl-shift-alt (the ctrl key, the left shift key and
the left alt key held down simultaneously), although this may be changed
in the configuration (explained later).

ARexx results:

RC=0
Result=undefined

Iconinfo:

Iconinfo [name]

Name optional; name of icon (or file with icon)

This command allows you to modify the characteristics of icons such
as stack size, default tool and tool types. It operates in a similar
fashion to the information menu item of Workbench. To use this command
you may either select the .info files themselves or the actual files
or directories the icons belong to.
A requester will appear when you run this command on a valid icon. The
actual appearance of the requester will vary depending on the type of
icon, but in all cases the actual icon imagery will be displayed. You
can click on this image with the left mouse button to display the
alternative imagery (if it exists).
The remap colours button will swap colours 1 and 2 of the icon
displayed. This can be useful to remap icons designed under os 1.3 for
usage under os 2.0, since os 2.0 swapped the light and dark colours around.
The information displayed for each icon is listed below. once you have
made the desired changes to the icon, the save button will save the changes
to disk. The skip and cancel buttons will exit without modifying the
icon on disk.

Drawer icon:

For a drawer icon you may edit the drawers protection bits, comment,
and tool types. The date of the last modification of the drawer is
also displayed.

Project icon:

For a project icon you may edit the projects stack size, default tool
and tool types. Also displayed are the size of the project in bytes
and the blocks, and the last modification date.

Tool icon:

For a tool icon you may edit the tools protection bits, stack size,
comment and tool types. Also displayed are the size of the tool in
bytes and blocks, and the last modification date.

Disk icon:

For the disk icon you may edit the disks default tool. Displayed are
the total number of blocks, and the number of blocks used and free.
The block size, creation date and disk status are also displayed.

Trashcan icon:

For a trashcan icon the only information available is the last
modification date.

Protection bits (where appropriate) are modified in the same way as
with the protect command, except that the hidden and pure bits are
not acceessible.
Tool types (where approprite) are modified in the same way as from
Workbench. To edit an existing tool type, simply select it, and press
return when you have modified it. To create a new tool type, select
the new button. To delete an existing tool type, select it and then
select the delete button.

ARexx results:

RC=0
Result=undefined

Install:

Install [drive] [ffs] [noboot]

Drive optional; drive to install

FFS optional; install a FFS bootblock

Noboot optional; make disk non-bootable

This command allows you to make a disk bootable. All bootable disks
have special information written to the first sector of the disk.
Without this, the disk will not boot.

ARexx results:

RC=0
Result=undefined

Installbg:

Same as install

This command will execute install in background mode. This allows you
to start up a diskcopy and still use Directory Opus.

ARexx results:

RC=0
Result=undefined

Lastsaved:

This command causes Directory Opus to read the last saved configuration
file. If you have modified the configuration, and have not yet saved it,
you are asked for conformation before this is done.

ARexx results:

RC=0
Result=undefined

Loadconfig:

Loadconfig name

Name configuration file to load

Loads the specified configuration file.

ARexx results:

RC=0
Result= 0 means success, 1 means some sort of failure.

Loadstrings:

Loadstrings name

Name string file to load

ARexx results:

RC=0
Result= 0 means success, 1 means some sort of failure

Loopplay:

Loopplay [name]

Name optional; name of file

Unlike the play command, the loopplay command plays a sound file repeatedly,
requiring a mouse button click to proceed to the next one.

ARexx results:

RC=0
Result=undefined

Makedir:

Makedir [name]

Name optional; name of directory

This command allows you to create a new sub-directory in the active
directory window.

ARexx results:

RC=0
Result=undefined

Modify:

Modify name value

Name name of item to modify

Value new value

This command allows you to make quick changes in certain configuration
options from buttons or menus, rather than going through the configuration
program. The modify command allows changes to at least two characteristics
the name of the option to change, and the new value (s) for it. Most values
are actually a combination of flag bits; to determine the desired value,
you simply add the values of the flag bits together. You can also add
and subtract bits. To do this, specify each bit (or combination of
bits)that you wish to add or subtract, preceded by the appropriate
sign (+ for add and - for subtract).
The options you can change are:-

Banknumber:

Allows you to specify the bank being shown.

Banknumber num

Buttonrows:

Corresponds to buttons/button rows menu.

Buttonrows rows

Copyflags:

Corresponds to operations/copy

Copyflags flags

Flags:

1= keep original datestamp
2= keep original protection bits
4= keep original comment
8= set archive bit
16= check destination free space.

Dateformat:

Corresponds to operation/date format

Dateformat flags

Flags:

1= Amigados format (dd-mmm-yy)
2= International format (yy-mm-dd)
4= Usa format (mm-dd-yy)
8= English/australian format (dd-mm-yy)
16= Name substitution (today, tomorrow, etc)
32= 12 hour clock

Defaulttool:

The current default tool for project icons created with addicon.

Defaulttool toolname

Deleteflags:

Corresponds to operation/delete

Deleteflags flags

Flags:

1 = ask before commencing delete
2 = ask before deleting files
4 = ask before deleting non-empty directories
8 = set delete protection bit

Dirflags:

Corresponds to system/directories.

Dirflags flags

Flags:

1 = always move to empty buffer
2 = use exall() to read directories
4 = auto diskchange
8 = auto disk load
16 = search buffers on double-click
32 = re-read changed or incomplete buffers
64 = search buffers on parent/root operation
128 = expand pathnames

Displaylength:

Corresponds to operation/list formats length fields.
This sets the lengths of some of the directory list items.
displaylength win type length
win is the window to act upon (-1=current window, 0=left or 1=right).

Types:

0 = name
1 = comment
2 = filetype

Errorflags:

Corresponds to operation/errorcheck

Errorflags flags

Flags:

1 = diable dos requesters
2 = display error requester

Fadedelay:

Corresponds to system/view and plays fade delay.

Fadedelay time

Filter:

Adjust the global filename filter. If filepattern is not given then
global filter is turned off.

Filter [filepattern]

Font:

Corresponds to screen/fonts. This takes three values; the id number of
the font to change, the name of the new font, and the point size of
the font.

Font idnumber font size

Idnumbers:

0 = general (8 point font)
1 = directory window font
2 = text viewer font
3 = buttons
4 = menus
5 = status bar
6 = disk names
7 = clock bar
8 = requesters
9 = path fields
10 = button iconify

Generalflags:

Corresponds to operation/general

Generalflags flags

Flags:

2 = display info
8 = file double click
64 = window slider activate
128 = click-n-click drag

Helpfile:

Allows you to specify a help file to load

Helpfile pathname

Hidepattern:

Corresponds to system/show patterns hidepattern

Hidepattern pattern

Iconflags:

Corresponds to operation/icons

Iconflags flags

Flags:

1 = create icons with directories
2 = perform all actions on icons as well
4 = select icons automatically

Iconifyflags:

Corresponds to system/clocks.

Iconifyflags flags

Flags:

1 = memory monitor
2 = cpu monitor
4 = date
8 = time
16 = no window
32 = appicon
64 = memory in bytes
128 = c: and f:

Note that no window and appicon are mutually exclusive. If the two flags
are specified together the results will be unpredictable.

Listformat:

Corresponds to operation/list format. The value of this is not a combination
of flags, but instead a list of numbers representing items.

Listformat win items

Win is the window to act upon (-1=current window, 0=left or 1=right)
items is up to five numbers, which indicate what data is to be displayed
and in what order.

Items:

0 = none
1 = size
2 = protection
3 = datestamp
4 = comment
5 = filetype

Outputcmd:

Correspond to system/amigados/output command.

Outputcmd shellcommand

Outputwindow:

Corresponds to system/amigados/output window.

Outputwindow consoledefinition

Replaceflags:

Corresponds to operation/copy

Replaceflags flags

Flags:

1 = always replace files
2 = never replace files
4 = replace only older files
8 = ask before replacing

Screenmode:

Corresponds to screen/screenmode

Screenmode mode

Mode values

1 = open on workbenchs screen
2 = open a clone of workbenches screen

Under os2.0/os3.0 other mode ids are supported. some common mode ids are


32768 = high res screen
32772 = high res laced screen
32800 = super high res screen
32804 = super high res laced screen
233508 = productivity screen
233509 = productivity laced screen
266240 = a2024 10 hz screen
299008 = a2024 15 hz screen

Scrdepth:

Corresponds to screen/screen modes depth. The depth can be 2, 3, or
4 bitplanes. That is the same as four, eight or sixteen colours.

Scrdepth depth

Screenflags:

Corresponds to screen/screen mode.

Screenflags flags

Flags:

1 = use default screen width
2 = use default screen height
4 = half-height screen

Scrclockflags:

Corresponds to system/clocks.

Scrclockflags flags

Flags:

1 = memory monitor
2 = cpu monitor
4 = date
8 = time
64 = memory in bytes
128 = c: and f:

Scrh:

Corresponds to screen/screen modes height.

Scrh height

Scrw

Corresponds to screen/screen modes width.

Scrw width

Separatemethod:

Corresponds to operation/list formats cycle button.

Separatemethod win method

Win is the window to act upon (-1=current window, 0=left or 1=right).

Methods:

0 = mix files and directories
1 = displays directories first
2 = displays files first

Showdelay:

Corresponds to system/view and plays show delay.

Showdelay delay.

Showfreeflags:

Corresponds to system/directory flags.

Showfreeflags flags

Flags:

1 = bytes free
2 = kilo/megabytes free
4 = blocks free
8 = precentage of space free

These bits are mutualy exclusive. If more than one is specified at
a time the results will be unpredictable.

Showpatbits:

Corresponds to system/show patterns hidden bit flag.

Showpatbits flags

Flags:

1 = hide files with hidden bit set.

Showpattern:

Corresponds to system/show patterns show pattern

Showpattern pattern

Sortflags:

Corresponds to operation/list formats sort flag.

Sortflags flag

Flags:

1 = reverse sort in the left window
2 = reverse sort in the right window

Sortmethod:

Corresponds to operation/list formats checked sort item.

Sort method win item

Win is the window to act upon (-1=current window, 0=left or 1=right).

Items:

0 = name
1 = size
2 = protection
3 = datestamp
4 = comment
5 = filetype


Updateflags:

Corresponds to operation/update.

Updateflags flags

Flags:

1 = update free disk space
2 = scroll directory window to follow operations
4 = redraw more than a quarter of a page
8 = directory refresh using startnotify ()
16 = left-justify filename in status bar
32 = display progress indicator

Viewplayflags:

Corresponds to system/view and play.

Viewplayflags flags

Flags:

1 = black background between pictures
2 = turn audio filter off for 8svx play
4 = 8-bits per gun colour
8 = loopplay 8svx sound file on double click
16 = text view borders
32 = start animations paused

Windowsize:

Adjusts the placement of the centre bar of Directory Opus directory
windows.

Windowsize offset

Any modify command that change display characteristics (screen size,
mode and depth, list format, etc) will not take effect until you execute
the redraw command. For commands that only change directory display
characteristics, you use the displaydir command to update the directory
display. Some modifications (like date format, hide and show patterns,
etc) will not take effect until the directory is actually re-read
( for instance, when the rescan command is used). For example, you could
have two buttons configured to switch between a high res screen with
8 colours, and a high res interlaced screen with 4 colours. The definitions
for these buttons might be:

Laceon -command modify screenmode 32772
        command modify scrdepth 2
        command redraw

Laceoff-commnad modify screenmode 32768
        command modify scrdepth 3
        command redraw

As another example, you might wish to change the left window to be sorted
by date, but to leave the right window alone. For this, you would have the
command:

Commannd modify sortflags 0 3
Command rescan 0

ARexx results:

RC=0
Result=undefined

Move:

Move [name] [destination]

Name optional; name of file

Destination optional; destination path

This allows you to move all selected files and directories from the
active directory window to the inactive window. The file or directory
will be copied to the destination, and the original will be deleted.

ARexx results:

RC=0
Result=undefined

Moveas:

Moveas [name] [new name]

Name optional; name of file

New name optional; new file name

This command moves all selected files and directories from the active
directory window to the inactive window, and allows you to specify a
new name for each file or directory. The file or directory will be copied
to the destination under the new name, and the original will be deleted.

ARexx results:

RC=0
Result=undefined

Newcli:

Newcli [handle]

Handle optional; cli console handle to use.

This command opens a cli from within Directory Opus, using the output
window defined in the configuration. The new cli will be separate from
Directory Opus, so to end the cli you must type endcli, as usual.

ARexx results:

RC=0
Result=undefined

Nextdrives:

This command simply flips to the next bank of drive buttons.

ARexx results:

RC=0
Result=undefined

None:

This command deselects all files and directories in the active directory
window.

ARexx results:

RC=0
Result=undefinined

Otherwindow:

This is the same as pressing the space bar, and activates the inactive
directory window.

ARexx results:

RC=0
Result= 0 left window is now active, 1 right window is now active.

Parent:

Parent [win]

Win optional; window to do a parent of
(-1=current window, 0=left or 1=right)
defaults to -1.

This will read the parent directory of the directory open in the active
or specified directory window. There are also two hidden parent buttons;
one for each directory window. They are hidden in the outermost borders
(on the left of the screen and the right of the screen)of the directory
windows.

ARexx results:

RC=0
Result=undefined

Patternmatch:

Patternmatch pattern string

Pattern pattern string

String string to match to pattern

This will returrn a boolean value to indicate whether the supplied
string matches the supplied pattern (which may include full wildcards)

ARexx results:

RC=0
Result=0 if string does not match, 1 if it does.

Play:

Play [name]

Name optional; name of file

This will attempt to play each selected file. If the file is an 8SVX
format iff sampled sound (of the type generated by audio master, for
instance), the speed and other information from within the file will
be used. The play routine plays both mono and stereo iff 8svx files.
When playing a file that is not iff 8svx, it will assume a speed of
10000 samples/second. This command also plays song modules. See playst
for more information. Each file is played once only, unlike the loopplay
command, which plays each file continuously. If the system/view/play/turn
audio filter off or for play option is selected, the high pass filter
will be turned off while a sound is playing.

ARexx results:

RC=0
Result=undefined

Playst:

Playst [name]

Name optional; name of file

Play a song module. Directory Opus supports sound/noise/protracker,
oktalizer and med modules.

ARexx results:

RC=0
Result=undefined

Print:

Print [name]

Name optional; name of file

The print routine is a full featured text formatter.
You can have a header and/or footer printed at the top and bottom of
each page if you wish. Both the header and footer can consist of the title,
the current date and the page number. You may select any combination
of title, date and page number you wish. If none are selected, the header
or footer is not printed.
You may also select the typestyle of the header and the footer, by clicking
on the buttons that initially say normal. These allow you to cycle through
the various typestyles avaiable:normal, bold, italics, underline, doublestrike
and shadow. Note that some printers may not have all these typestyles
available.
You may enter a title (to be used in the header and footer)in the title
string field. Leaving this blank will cause the name of the file to be
used as a title.
The output field allows you to specify where you want the output of the
print process to go. This defaults to prt:, but you may choose to have
the output sent to a disk file. In this case, simply enter the path and
the name of the file you wish to print to.
The cycle button labeled quality allows you to specify whether all text
is printed in draft mode or nlq mode.
The button below that determines whether or not the last page of the file
to be printed is followed by a formfeed character, which would cause
it to be ejected.
To start the print operation, select the print button.
This command will print all selected files, one at a time. If you select
only one file to print, theprint routine will be started up as a separate
process, allowing you to continue working with Directory Opus. To cancel
this type of print, select the print command again. A requester will appear
aasking if you want to continue with the print or halt it. This requester
will also appear if you attempt to quit Directory opus while a print
operation is in place, as you cannot quit until the print has finished.
To cancel a print job that has not been sent to the printer yet, simply
press the left and right mouse buttons in the normal way.
Even if you abort a print, the printer may not actually stop for sometime.
This is because most printers have print buffers, some quite large ones,
which must empty the data they have stored into the printer first.

ARexx results:

RC=0
Result=undefined

Printdir:

Printdir [win]

Win optional; widow to scan the buffer list into
(-1=current window, 0=left or 1=right)
defaults to -1.

This command allows you to print the directory in the active directory
window. You are able to choose the information you want to print (file
sizes, protection bits, dates and comments). This command is not started
as a separate process, unlike the print command. Printdir also allows you
to specify the output file to which the directory is to be printed.
This can be prt: (i. e. , your printer, the default)or a disk file.

ARexx results:

RC=0
Result=undefined

Protect:

Protect [name] [bits]

Name optional; name of file

Bits optional; bits to set on given file

The protect command now allows you to specify bit-masking. This lets
you mask some bits as untouchable. You can selectively add or remove
certain bits while leaving other bits in their original state.
To select a mask, click on the characters following the mask:string.
if a mask bit is turned on, its character equivalent will be displayed;
otherwise a hyphen (-) character will be displayed. No mask bits that
are tuned on will be modified during the protection operation.

ARexx results:

RC=0
Result=undefined

Query:

Query item [win]

Item configuration item to query

Win optional; window argument that some items need
(-1=current window, 0=left or 1=right)
defaults to -1.

Returns the current value of a specific configuration item. These items
are described in the modify command. Any item that can be modified can
be queried.
Several of the configuration items need an additional window argument.
These are listformat, displaylength, sortmethod and separatemethod.

ARexx results:

RC=0
Result=current value of the specified item

Quit:

Quit [force]

Force optional; do not ask user for confirmation.

This command will exit Directory Opus (providing there is not a print
operation happening at the time). If the configuration has been modified
and not saved, you are asked if you wish to save it first.

ARexx results:

RC=0
Result=undefined

Read:

Read [name]

Name optional; name of file

This command allows you to read selected files. At the bottom of the
screen the name of the file is displayed, along with the current position
within the file in lines and as a percentage, and also the total number
of lines in the file.
The mouse is used to move through the file. Press the left mouse button
to turn scrolling on or off. The direction of the scroll is governed
by the position of the mouse pointer in the window. The mouse pointer
will become invisible while the text is scrolling.
No scrolling occurs if you have the mouse in the centre of the window.
To scroll forward, move the mouse down until the text starts to scroll.
The further down you move the mouse, the faster the text will scroll.
This procedure is reversed for backwards scrolling.
The buttons in the bottom right of the screen also allow you to move
around the file. Most buttons will repeat if held down for any length
of time.
The up and down arrows move up and down a line at a time. The u and d
buttons move up and down a page at a time. The t and b buttons move to
the top and bottom of the file.
You can also use the cursor keys to move up and down. as before, in
conjunction with shift these keys will move a page at a time, and in
conjunction with ctrl they will move to the top and bottom of the
file.
To jump to a specified line, click on the number showing the current
line position (immediately to the left of the word lines). You can
also press the j key. To jump to a specified percentage, click on the
number immediately to the left of the % sign.
To search for a string, click on the s button or press the s key. You
can use full pattern matching in this search.
To print the current file, click on the p button (or press the p key).
To print only the current page, press the c key (this has no button
equivalent).
To leave the text viewer, click on the x button, or press either x, q
or esc.
If more than one file was selected, the next one will be read when you
exit. To exit without reading the next file, press the right mouse
button.

ARexx results:

RC=0
Result=undefined

Redraw:

This command will completely redraw the Directory Opus screen. The
screen is closed and then re-opened.

ARexx results:

RC=0
Result=undefined

Relabel:

Relabel [device newname]

Device optional; device to relabel

Newname new name to give selected device

This command allows you to change the name (label) of the disk that
is open in the active directory window.

ARexx results:

RC=0
Result=undefined

Remember:

This command allows you to make temporary changes with the modify
command, and then restore all the settings later.

ARexx results:

RC=0
Result=undefined

Removeentry:

Removeentry number show

Number number of entry to remove

Show boolean indicates whether to update display

Removes an entry by ordinal number

ARexx results:

RC=0
Result=0 entry was not found, 1 entry was found and removed

Removefile:

Removefile name show

Name of the file entry to remove

Show boolean indicates whether to update display

This command removes the specified entry from the active directory
window, and returns a boolean indicating whether the entry was found
and removed. Show is a boolean value indicating wether you want the
display updated or not.

ARexx results:

RC=0
Result=0 entry was not found, 1 entry was found and removed

Rename:

Rename [name newname]

Name optional; name of file

Newname to give to selected file

This allows you to rename all selected files and directories. You may
use a * to specify a pattern. If no * is used, you are asked for a new
name for each individual file.
To add a prefix or a suffix (or both) to all selected entries, use *
in the second string field. For example, to add hires as a prefix and
.pic as a suffix to all selected entries, enter hires*.pic.
To change a prefix or suffix (or both) of all selected entries, use
a * in the top string field. For example, to change hires to medres
as a prefix, and .pic to .iff as a suffix, enter hires*.pic in the top
string field, and medres*.iff in the bottom string field.

ARexx results:

RC=0
Result=undefined

Request:

Request message

Message text to print in the requester

Displays requester with given message text

ARexx results:

RC=0
Result=0 cancel was selected, 1 okay was selected

Rescan:

Rescan [win]

Win optional; window to rescan

(-1=current window, 0=left or 1=right)
defaults to -1.

This causes the directory in the active window to be re-read. this
has exactly the same effect aas activating the directory string
field and pressing return, without modifing the directory name.

ARexx results:

RC=0
Result=undefined

Reselect:

This command will reselect all entries that were selected before the
last opeeration was initiated.

ARexx results:

RC=0
Result=undefined

Restore:

This command is used to restore the previously remembered settings.

ARexx results:

RC=0
Result=undefined

Root:

Root [win]

Win optional; window to scan the buffer list into
(-1=current window, 0=left or 1=right)
defaults to -1.

This command reads the root directory of the active or specified
directory window.
There are two hidden root buttons; one for each directory window.
They are hidden in the outermost borders (on the left of the screen
and the right of the screen) of the directory windows. With the left
mouse button, these buttons perform the parent command; when selected
with the right mouse button they will load the root directory.

ARexx results:

RC=0
Result=undefined

Run:

Run [name]

Name optional; name of file

This command allows you to run each selected file in turn, providing
that file is executable. This will have much the same effect as if you
had double-clicked on the files icon, or run it from the cli. A requester
will appear, asking for arguments (should the program require any).

ARexx results:

RC=0
Result=undefined

Saveconfig:

Saveconfig [filename]

Filename optional; configuration file to save to

This command saves the configuration to the file that it was read
from initially.

Scandir:

Scandir path [win]

Path path to read

Win optional; window to read directory into
(-1=current window, 0=left or 1=right)
defaults to -1.

This command allows you to read a directory in much the same way as
the drive buttons. For example:

Command scandir dh0:work
would read the dh0:work directory into the current window.
One usage of this allows you to have an entire bank of buttons
devoted to "drive buttons". You could then set up a button on
every other bank that would, using the modify command, jump to that
bank.

ARexx results:

RC=0
Result=undefined

Scrollh:

Scrollh chars [win]

Chars characters to scroll

Win optional; window to scroll
(-1=current window, 0=left or 1=right)
defaults to -1.

This will scroll the directory window horizontally by the specified
number of characters (either positive or negative).

ARexx results:

RC=0
Result=new horizontal position

Scrolltoshow:

Scrolltoshow entry [win]

Entry entry to make visible. May be either a name or wildcard
pattern, or the ordinal number of the desired entry.

Win optional; window to scroll
(-1=current window, 0=left or 1=right)
defaults to-1.

This command will try to scroll the specified entry into view.

ARexx results:

RC=0
Result=0 if entry was not found, 1 if it was found.

Scrollv:

Scrollv lines [win]

Lines lines to scroll

Win optional; window to scroll
(-1=current window, 0=left or 1=right)
defaults to -1.

This will scroll the directory window vertically by the specified
number of lines (either positive or negative).

ARexx results:

RC=0
Result=new vertical position

Search:

Search [name] [pattern] [ucnic] [wild] [byword]

Name optional; name of file

Pattern optional; text pattern to search for

Ucnic optional; uppercase characters does not equal lowercase
characters.

Wild optional; pattern contains wildcard characters

Byword optional; match only whole words

This command allows you to search all selected files for a specified
string, which may contain wildcards. If a match is found you are told
which file conains the string, and you are given the option to enter
the text viewer and read the file. If you opt to do this, a search for
the string is automatically initiated once the file has been read
by the text viewer. If any directories are selected, all the files
within those directories are also searched.
the flags ucnic, wild and byword are off by default.

ARexx results:

RC=0
Result=undefined

Select:

Select [pattern] [onlyfiles] [onlydir] [name] [date] [protection]

Pattern optional; pattern to select by

Onlyfiles optional; select only files, defaults to both files and
directories.

Onlydirs optional; select only directories

Name optional; match on name, (default)

Date optional; match on date

Protection optional; match on protection bits

When used in name mode (default) this command allows you to select
files and directories in the active directory window using wildcards.
All standard wildcards are supported #. ?, |, %, (, ), [, ], *, ~ and `.
when used in date mode you can select all files and directories created
or modified on a certain date only. Simply enter that date (e. g. , 28-mar-90
would select all entries with datestamps set to any time on the 28th of
march, 1990). you can also use words like yesterday, today, tuesday, etc.
you can also specify a specific time. Simply enter the time (in the
format hh:mm:ss). If you enter a time, however, the datestamp must match
that time exactly for the entry to be selected. Of you enter a time but
not a date it will select files created today that match that time.
You can also select a range of dates. for instance, to select all entries
created or modified between the 18th of april 1989 and the 22nd of
september 1991, you would enter:

18-apr-89 > 22-sep-91

The > character does not in this case signify "greater than"; it simply
indicates a range of dates. It must have at least one space on either
side of it. To select all files from the beginning of time to, for
instance, the 3rd of january 1990, you would enter: > 3-jan-91
to select all files from, for example, the 12th of july, 1983 to the
current date (today) you would enter: 12-jul-83 > you may also
specify times when entering date ranges. If used in protect bit mode
you may specify protection bits that are allowed to be set, and bits
that are not. If a bit or group of bits is allowed to be set, precede
it with a + character. If a bit or group of bits is not allowed to be
set, precede it with a - character. the initial + character is assumed.
For instance, to select all readable and writable files, you would simply
enter: rw or, you could enter +rw. Both these would have the same effect.
To expand upon this, and select all readable and writable files, but not
those that have the hidden or archive bits set, you would enter:
rw-ha or, toselect files that do not have the bits sped set, you would enter
-sped
The select command is additive; i. e. , entries not matching the given
pattern are not deselected.

ARexx results:

RC=0
Result=undefined

Selectentry:

Selectentry number

Number ordinal number of entry to select

State optional; selection state
(-1=toggles, 0=unselect and 1=select)
defaults to -1.

Show optional; boolean indicating whether to update display

Selects an entry in the active window

ARexx results:

RC=0
Result=previous select status of entry or -1 if it could be found

Selectfile:

Selectfile name [state] [show]

Name name of entry to select

State optional; selection state
(-1=toggles, 0=unselect and 1=select)
defaults to -1.

Show optional; boolean indicating whether to update display

This command will select the entry specified by filename, as if it had
just been clicked on.

ARexx results:

RC=0
Result=previous select status of file or -1 if it could not be found

Setwintitle:

Setwintitle title [win]

Title title string to use

Win optional; window to modify
(-1=current window, 0=left or 1=right)
defaults to -1.

Sets title of active or specified window to given string.

ARexx results:

RC=0
Result=undefined

Show:

Show [name]

Name optional; name of file

This command is very versatile indeed. it will display IFF ILBM pictures
and brushes, Workbench icons and fonts.
if the file is an IFF ILBM, it will be displayed using information from
the file. Directory Opus will correctly show most pictures and brushes,
including overscan, extra halfbrite (ehb), ham pictures (4096 colours),
and the new aga display modes of the A4000 and A1200, including ham8
with 262144 colours at once. If the picture contains colour cycling
information, pressing tab will toggle colour cycling on or off. You can
press p to print the picture. Should you wish the mouse pointer to be
visible (in order to point at some part of the picture, for instance),
press the . (period) key. The show routine will also display icons. If
the file has a .info suffix it is assumed to be an icon. If the icon
has an alternative image, pressing return will toggle between the two.
To display a font, you need to enter the actual font drawer, and show
the size file. That is, the file 8, 12, 19, etc, not the .font file.
if you press the help key while viewing a picture, font or icon, a screen
will appear showing information about what you were looking at. You can
also print what you are looking at.

ARexx results:

RC=0
Result=undefined

Smartread:

Smartread [name]

Name optional; name of file

This command invokes the text viewer in the same way as the read command.
However, it checks the file for binary characters, and if any are found,
the file is hexread instead.

ARexx results:

RC=0
Result=undefined

Status:

Status value [set newvalue]

Value indicates the type of status you want

Set newvalue optional; set the status to the specified value

This command returns the value for the specified status command (listed
below). If the set keyword is specified, this command will set the status to
the specified value (if appropriate for that status command). Most status
values can be set.
Some status commands require a sub-number. an example of this is status
4, which returns the total number of files in a specified directory
window. The directory window may be either 0 (for the left-hand window),
1 (for the right-hand window) or -1 (for the active window). The command
would therefore be status 4 0 for the left-hand window, and status 4 1
for the right-hand window.

Status values are as follows:

1 Current directory:

This returns or sets the pathname of the current directory

Status 1 [set path]

2 Version:

This returns the current version number (as a string)

Status 2

3 Active window:

This returns or sets the active directory window (either 0 or 1).

Status 3 [set win]

4 Number of files:

This returns the total number of files in a directory window.

Status 4 win

5 Number of dirs:

This returns the total number of directories in the directory window.

Status 5 win

6 Number of entries:

This returns the total number of entries in the directory window.

Status 6 win

7 Number of selected files:

This returns the total number of selected files in the directory window.

Status 7 win

8 Number of selected dirs:

This returns the total number of selected directories in the directory
window.

Status 8 win

9 Number of selected entries:

This returns the total number of selected entries in the directory window.

Status 9 win

10 Total bytes:

This returns the total number of bytes (sum of the lengths of all files)
in the directory window.

Status 10 win

11 Total selected bytes:

This returns the total number of selected bytes (sum of the lengths
of all selected files)in the directory window.

Status 11 win

12 Select pattern:

This returns or sets the current select pattern (used in the select
command).

Status 12 [type] [set pattern]

Types....

0=name, default
1=date
2=bits

13 Directory name:

This returns the name of the directory that is open in the specified
window. Setting this to another pathname will read that directory.

Status 13 win [set path]

14 Disk name:

This returns the name of the disk that is open in the directory window.
this cannot be set (use the relabel command to change the disk name).

Status 14 win

15 Disk free bytes:

This returns the number of bytes free on the disk open in the directory
window.

Status 15 win

16 Disk total bytes:

This returns the total number of bytes (free+used) on the disk open
in the directory window.

Status 16 win

17 Buffered directory name:

This returns the pathname of the directory that is stored in a specific
directory buffer (from 0 to 255).

Status 17 win buf

18 Buffered diskname:

This returns the diskname of the directory stored in a specific directory
buffer (from 0 to 255).

Status 18 win buf

19 Buffered disk free bytes:

This returns the free space on the disk whose directory is stored in
a specific directory buffer (from 0 to 255). This data may no longer
reflect the actual free space on that disk.

Status 19 win buf

20 Buffered disk total bytes:

This returns the space used on the disk whose directory is stored
in a specific directory buffer (from 0 to 255).
This data may no longer reflect the space used on that disk.

Status 20 win buf

21 Buffer displayed:

This returns the number of the buffer that is displayed in the directory
window, a number from 0 to 255. If this is set to a specific buffer that
buffer will be the one shown in the directory window.

Status 21 win [set buf]

22 Unused in Directory Opus 4.01

23 Unused in Directory Opus 4.01

24 Entries per page:

This returns the number of entries that can be displayed per page.

Status 24

25 Configuration changed:

This returns a boolean value to indicate whether the configuration
has been changed since it was last saved.

Status 25 [set state]

26 Okay string:

This returns the name of the okay string in requesters. This also allows
you to select the text of the positive button for the request and getstring
commands.

Status 26 [set string]

27 Cancel string:

This returns the name of the canecl string in requesters. This also allows
you to select the text of the negative button for the request and getstring
commands.

Status 27 [set string]

28 Currently iconified:

This returns a value indicating whether Directory Opus is currently
iconified and if so what type of iconification it is. This will return
0 if not iconified, 1 if iconified and 2 if button iconified.

Status 28

29 Unused in Directory Opus 4.01

30 Top text justification:

This returns a value indicating how the text in the status bar is rendered.

Status 30 [set type]

Types....

0=left
1=right
2=centre

31 Unused in Directory Opus 4.01

32 Unused in Directory Opus 4.01

33 Unused in Directory Opus 4.01

34 Unused in Directory Opus 4.01

35 Unused in Directory Opus 4.01

ARexx results:

RC=0
Result=depends on which status was requested.

Stopst:

Stops playing a song module.

ARexx results:

RC=0
Result=undefined

Swapwindow:

Swaps the contents of the two directory windows.

ARexx results:

RC=0
Result=undefined

Techsupport:

This command displays some information on how to contact technical
support.

ARexx results:

RC=0
Result=undefined

Toggle:

This command reverses the state of all files and directories in the
active directory (i. e. all selected entries are deselected, and vice
versa).

ARexx results:

RC=0
Result=undefined

Toptext:

Text text string to display

Displays given string in the status bar.

ARexx results:

RC=0
Result=undefined

Uniconify:

Returns to main program from iconified state.

ARexx results:

RC=0
Result=undefined

User1, user2, user3, user4:

These commands will invoke the four user definable commands
associated with your filetypes, in the default configuration the
command user1 is defined to extract files from archives.

ARexx results:

RC=0
Result=undefined

Verify:

Verify [text]

Text optional; text to display in requester

Displays "are you sure?" requester. if this is included in a multi-
command operation, cancel will abort the rest of the commands.

ARexx results:

RC=0
Result=0 is cancel, 1 is okay

Version:

This command displays information about Directory Opus, Kickstart,
Workbench and your computer.

ARexx results:

RC=0
Result=undefined

4. 1 Simple argument functions:

{d} Destination directory windows path

This will insert the path of the destination directory window.

{f} First selected entry (with path)

Insert the path and filename of the first selected entry. The entry will
then be deselected.

{f} All selected entries (with paths)

Insert the path and filenames of all selected entries. The entries will
then be deselected.

AmigaDos has limited the length of the command line to 256 characters.
Therefore, if the length of acommand line exceeds 256 characters because
of a {f} sequence (or for any reason), another command line will be created
for the next lot of file entries until there are no more selected file
entries.

{fu} First entry (with path, do not deselect)

The same as {f} except that the entry is not deselected.

{fu} All entries (with paths, do not deselect)

The same as {f} except that the entries are not deselected.

{o} First selected entry (name only)

The same as {f} except that only the name of the first selected entry
is used, without the pathname.

{o} Allselected entries (names only)

The same as {f} except that only the names of the selected entries
are used, without the pathname.

{ou} First entry (name only, do not deselect)

The same as {o} except that the entry is not deselected after it is used.

{ou} All entries (names only, do not deselect)

The same as {o} except that the entries are nor deselected after they are
used.

{p} ARexx port/public screen name

This will insert the name of the rexx port for this invocation of Directory
Opus. Every Directory Opus running will have a unique Rexx port name.
this is the same name used for the public screen name.

{s} Scource directory windows path

This will insert the path of the scource directory window.

4.2 Requester functions:

{rdtitle:default} Directory requester

Default can be any valid pathname.

{rftitle:default} File requester

Default can be any valid pathname or filename

{rftitle:default} Multi-select file requester

Default can be any valid pathname or filename

{rotitle:default} Font requester

Default can be any fontname. a pointsize can be specified with a slash
followed by a number (i.e. topaz/8).

{rstitle:default} Requester that asks for some text

Default can be any text.

The title string that will appear on the requester. You can just omit
the title string, in which case a default title will be used.

The default string (preceded by a colon) is the default string that
is to appear in the requester. this too can be omitted.
The default string can contain bracketed letters. These tell Directory
Opus where to insert additional information into the requester. The
supported bracketed letters include...

[o] Inserts the last referred filename, only the filename

[f] Inserts the last referred filename, both path and filename

[s] Inserts the source directory windows path

[d] Inserts the destination directory windows path

For example, it would be possible to have your own custom rename button
with the following call function:

c:rename {f} {reenter new filename:foo. [o]}

In this case a string requester would open with the title "enter new
filename"and the default of the string field would be "foo. " Followed
by the selected filename.



                                 Chapter 5:

Appendices:

5. 1 Glossary:

Some terms used in this manual that you may need to know are:

Active:

(directory window)

Denoted by a highlighted disk name.

This is the scource directory, the directory that all commands will
act upon.

Buffers:

A directory buffer is an internal storage area for directory information.
whenever Directory Opus reads directory information from a disk, it
stores the information in a directory buffer. By storing the directory
information in a buffer, Directory Opus can avoid unnecessarily re-reading
the disk.

Click-m-click:

This is a Directory Opus term. To click-m-click is to click once with
the mouse button, move the mouse to another part of the screen, and press
the mouse button again, all within the double-click time set from
preferences.

Directory window:

One of the two windows on the screen in which entries are displayed.

Double-click:

An Amiga term, this means to click twice with the mouse button (usually
the left button, but sometimes the right button) on an object, within a
pre-determined time. The time is set from within preferences, and you
should consult your Amiga manual for more information on this.

Drive gadgets:

The 30 gadgets, of which only six are visible at once, that enable you
to easily read any directory.

Entry:

Either a file or a directory.

File types:

A file type is a set of user-defined tests to see whether a file is
of a certain type or not. Actions can then be performed on the file,
depending on its type.

Highlight:

Highlight is the term given to the changing or reversal of colours,
usually when an object is selected.

Inactive:

(directory window)

Disk name is not highlighted. This is the destination directory, and
files may sometimes be written here from the scource directory.

Menu:

A pull-down menu is like a list of gadgets. A menu is accessed by
moving the mouse to the top of the screen and holding the right
mouse button.

Open:

A directory that is currently displayed is said to be open.

Requester:

A requester is usually a box that appears on the screen, soliciting
a responce. Some requesters require a string input, others simply
ask you to choose yes or no.

Rmb button:

A Directory Opus term. This is a button that is selected with the right
mouse button, instead of with the left.

Selected:

Entries are selected when they are highlighted. This is usually done
by clicking on them with the left mouse button.

5. 2 How we start external programs:

Directory Opus uses the small (4k) AmigaDos program. Dopusrt, to help
it launch Amigados, Workbench, batch and ARexx programs. When you
start up an external program a script file is created in the t:
directory. This script file contains all the initialization and execution
code needed to start up and manage your programs.
The Dopusrt program is called at the end of the script file, and
communicates with Directory Opus to inform it when the script file has
finished running. This is needed for functions that are not run
asynchronously. It also doubles as a wait command, which is needed for
the adjustable close delay.
To take advantage of the current directory changing, adjustable stack,
and priority you will need the commands cd, stack and changetaskpri in
your computers c: directory. You will also need the commands run, execute,
failat, newcli and endcli. These are almost always present in your c:
directory anyway, so you should not need to install them.
There are a couple of other points to be aware of. Because external
programs are run via a script file, they can be aborted like any other
script file by pressing ctrl-d. This is only possible if you have an
output window selected. If the script file is aborted in this fashion,
the output window effectively turns into a cli, so you must type endcli
to remove the window.
The second point is that if the program was not run asynchronously,
Directory Opus will be frozen, waiting for the siganl back from the
dopusrt program. If you abort the script file before it reaches dopusrt,
Directory Opus will never unfreeze. You can force Directory Opus to
unfreeze by activating the Directory Opus window and pressing shift-esc
(the shift key in conjuction with the escape key). This allows you to
turn any non-asynchronous program into an asynchronous program, while
the program is running.
Note that when using newcli or newshell as the output command, an error
such as unknown command will abort the script file as well. You should
therefore make sure that all your buttons, filetypes, hotkeys or menus
do not try to run nonexistent programs.

5. 3 Wild card patterns:

Directory Opus can use wild cards to make some tasks easier. Wild card
characters are expressions that tell Directory Opus to match (or not
match, in some cases) more than just one character. You may already
have encountered pattern matching in the descussion of the rename
command.

? This token will match any single character, but does not include
none. For example, fi?e would match file, fine and fire but not fie.

# This character tells Directory Opus to match the following expression
0 or more times. For instance, fre#d would match fre, fred, fredd, freddd, etc.
"#?" will match anything, just like "*" (see below).

() Is in effect an or (p1|p2|p3) will match on any one of the patterns
p1, p2 and p3. for instance, (d*g|c*t) would match dog, cat, dig, cot, etc.
you may include aas many patterns inside the parentheses as you like,
separated by vertical bars (|).

| Use this token within parentheses to separate different expressions
you wish to match at the same time. for example, "(ab|cd)" will match
any one of the items separated by "|" (here, "ab and cd).

% Matches 0 characters. This is always (usful in an instance like
"(foo|bar|%)"). another example: "ca(m|%)p" will match camp and cap.

* Synonym for "#?", an asterisk will match any number of repititions
of any characters, including none. For instance, "f*" will match f, fr,
fre, fred, fredd, freddy, etc.

~ The tilde can be used to negate an expression. Anything that would
normally match, now will not match. for example, "f~(rog)" will match
from but not frog. "~j*" will not match anything starting with j.

[] Brackets enclose a list of characters ( a "character class")
that match of the characters in the class. "[abc]" tells Directory
Opus to match either "a", "b", or "c" in this position.

~ A tilde at the begining of a character class matches any characters
that are not in the class. For example, [~bc]" says "match any character
except "b" or "c".

- A hyphen indicates a character range (only within character classes).
The expression "[a-z]" represents all the loweRCase letters from "a"
to "z".

` (Apostrophe or single quote) Use this character to declare the following
character to be a literal character, used as it stands instead of as a
wild card. This permits you to use the characters #, ?, |, %, (, ), [, ], *, ~
and even an apostrophe as themselves rather than as pattern-matching
control characters. For instance, year*`% will match year1989%, year1990%
but not year1989 or year1990 as would normally be the case, with % meaning
match on nothing. Note that this means that you must use `` to match an
apostrophe.
Note "expression" in the above tabe means either a single character
(ex:"#?"), or an alternation (ex:"#(ab|cd|ef)"), or a character class
(ex:"#[a-za-z]").

5. 4 Shortcut keys:

These are the default shortcut keys. Each of these can be redefined
using the configopus utility.

Addicon:  left shift ctrl i

        All:   ctrl a

ARC extract:  ctrl e

  Check fit:  ctrl f

      Clone:  ctrl l

    Comment:  left shift ctrl c

  Configure:  right amiga c

       Copy:  ctrl c

 Date stamp:  ctrl d

     Delete:  left shift ctrl d

       Edit:  left shift ctrl e

  Get sizes:  ctrl g

   HEX read:  ctrl h

       Hunt:  left shift ctrl h

     Iconfy:  right amiga i

  Icon info:  ctrl i

   Make dir:  ctrl m

       Move:  left shift ctrl m

       None:  ctrl n

     Parent:  ctrl p

       Play:  ctrl y

      Print:  left shift ctrl p

    Protect:  ctrl t

       Quit:  right amiga q

       Read:  ctrl r

     Rename:  left shift ctrl r

       Root: ctrl o

        Run:  ctrl u

     Search:  left shift ctrl s

       Show:  ctrl s

5. 5 Simple shortcut keys:

              Toggle help mode:  help

        Active directory field:  return key

              Max right window:  -

               Max left window:  \

                Centre windows:  =

          Change active window:  spacebar

     Scroll window up one line:  up arrow

   Scroll window down one line:  down arrow

          Scroll window to top:  shift up arrow

       Scroll window to bottom:  shift down arrow

Scroll window right one column:  right arrow

 Scroll window left one column:  left arrow

    Scroll window to far right:  shift right arrow

     Scroll window to far left:  shift left arrow

============================================================================

Changes made to Directory OPUS version 4.10 that are not reflected in the
printed manual. If you are just getting started, you may not be too
concerned with this information yet. However, there are a couple of new
options in the Configuration Program which do not appear in your printed
manual.These comments assume some familiarity with using Directory OPUS
and its configuration utility.

============================================================================

Directroy OPUS, Version 4.10
DOpus.Library,  Version 22.5



New Shortcut keys
-----------------

The following shortcut keys have been added:

        Shift-Return        Displays the Buffer List in the current window.
        Alt-Return          Displays the Device List in the current window.
        LAmiga-Space        Scrolls to first selected file
        RAmiga-Space        Scrolls to first selected directory
        ]                   Displays the next gadget bank
        [                   Displays the previous gadget bank


Furthermore, when showing a list of pictures, the Return key will proceed
to the next picture.

===============================================================================

Skip All while Searching
------------------------

When a text string is found while searching multiple files, a
requester appears asking you if you want to read the file. A
"Skip all" button has been added.  Selecting this button continues
searching the selected files without bringing up this requester.
As a result, the files containing the search text will remain
highlighted, files which do not contain the search text will be
deselected.  At this point you can do some other operation on the
selected files (the ones containing the text).  For example, this
is a great way to copy files which contain some text string.

===============================================================================

Choosing the Parent of your Choice
----------------------------------

You can now bring up a requester which shows all the Parent Directories
for the current directory.  Simply double-click on the current directory's
Diskname bar.  Selecting an entry and clicking Okay, or double-clicking
an entry will read the selected directory.

Also, if the current directory, or any of its parent directories have
multi-volume assigns (see your AmigaDos documentation), these will be
displayed in the list as well.

===============================================================================

Double-Click an already selected entry
--------------------------------------

You can now double click on a selected file or directory. Previously,
you had to un-select the entry before performing the double-click
operation. Now it will perform the appropriate double-click
operation.

===============================================================================

File Name completion
--------------------

If you are editing the Directory Field for a Directory Window, and
you are going to type the name of a sub-directory - you can save a
few keystrokes by starting the name and press the Help key.
Directory Opus will fill out the subdirectory name with the first
name which starts with the name you filled in. Subsequent presses of
the Help key will cycle through all matching directory names.

===============================================================================

Using Workbench Iconify Window as a File Viewer
-----------------------------------------------

You can drop Workbench Icons on Directory OPUS's Iconified Window
bar to view the file. OPUS will view the file in the same manner as
a double-click from Directory OPUS's main window. In other words, a
Picture is shown, a Text file brings up OPUS's text viewer, etc.

===============================================================================

Running Format, Diskcopy, Install, and Info requester from a Shell
------------------------------------------------------------------

You can run OPUS's Format, Disk Copy, and Install requesters
directly from an Amiga Dos prompt without going through Directory
OPUS. All three are contained in the program
DOpus:modules/DOpus_Disk.

You select between the three by giving a command argument of F
for Format, D for Disk Copy, and I for Install. For example:

    >DOpus_Disk F         ;Brings up Format
    >DOpus_Disk D         ;Disk Copy
    >DOpus_Disk I         ;Install

These can also be started from the Workbench; see below for the
required Tooltypes.

You can also run OPUS's Icon information requester directly by
running the program DOpus:modules/DOpus_Icon. It needs a filename
as an argument. The ".info" on the end is optional.

    >DOpus_Icon sys:prefs.info
    >DOpus_Icon sys:prefs


============================================================================

Tooltypes and Command Arguments
-------------------------------

The following Tooltypes and command arguments are supported:

  Directory Opus

   Tooltypes           Command Argument
   ------------------------------------------------------------------------
   ICONSTART               -i             Start iconified
   BUTTONSTART             -b             Start button-iconified
   CONFIGFILE              -c             Specify new configuration filename
   CHECK                   -g             Ch